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CHAPTER 1 

Extending Fireworks Overview 



To extend Fireworks, you must write JavaScript code. You can use JavaScript to write your own 
objects, behavior actions, and commands that affect Fireworks documents and the elements 
within them. To accomplish these tasks, you must be proficient in JavaScript and in Fireworks. 

This manual describes the Fireworks Object Model and the Fireworks JavaScript application 
programming interface (API) — the custom JavaScript functions that are built into Fireworks. 

Prerequisites 

Because Fireworks extensions must be written in JavaScript, this documentation assumes that 
readers are familiar with JavaScript syntax and with basic programming concepts such as 
functions, arguments, and data types. It also assumes that readers understand the concept of 
working with objects and properties. This documentation does not attempt to teach 
programming in general or JavaScript in particular. 

Anyone who wants to extend Fireworks should have a good JavaScript reference to help with 
syntax questions (for example, isitsubstring()orsubString()?). Useful JavaScript references 
include JavaScript Bible by Danny Goodman (IDG), JavaScript: The Definitive Guide by David 
Flanagan (O’Reilly), and Pure JavaScript by R. Allen Wyke, Jason D. Gilliam, and Charlton Ting 
(Sams). For a free JavaScript reference, see http://developer.netscape.com/docs/manuals/ 
javascript.html. 

Formatting nonstandard data types 

In addition to the standard data types that can be passed to functions as arguments, such as 
integer, string, and so on. Fireworks accepts other data types for certain functions. 

• Some functions take values that are Fireworks objects. These objects are explained in “The 
Fireworks Object Model” on page 7. 

• Some functions take a string in a specific format. Others take value types that are not Fireworks 
objects but are JavaScript object types that are specific to Fireworks. These types of arguments 
are described next, in alphabetical order. 

Color string 

Functions that take colors as arguments use the HTML syntax of "#rrggbb". You can 
specify a color with an alpha (transparency) component by passing a longer string of the 
form ''#rrggbbaa " . 
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Mask 



The format for mask is {maskBounds : rectang]e, maskKind: string, maskEdgeMode: string, 

feather Amount: int, maskOata: hex-string). 

• maskBounds specifies the bounding rectangle of the mask area. 

• Acceptable values for maskKI nd are " rectangl e", "oval ", "zl i b compressed", 

"rl e compressed", or "uncompressed". 

• If maskKind is "rectangle" or "oval ", the maskOata string is ignored, and a mask of the 
right shape is constructed that fills maskBounds and that has the edge specified by 
maskEdgeMode and featherAmount. 

• If mas/c/t/nd is "zl i b compressed", "rl e compressed", or "uncompressed", the mas/cData 
string is presumed to contain 8-bit mask data in hexadecimal format that precisely matches the 
maskBounds to define the mask. 



Matrix 

The format for a matrix is { fflatr/x.- [fl oat , float, float, float, float, float, float, 
float, float]!. This manual assumes that you know how to use these nine values to construct 
a three-by-three transformation matrix; discussion of the construction of transformation matrices 
is beyond the scope of this manual. 

Point 

The format for a point is { x; float, y: float). For instance, dom . add NewLi ne ( s tar tPo int, 
endPoint) could look like the following example: 

fw . getDocumentDOMl ) . addNewLi ne( I X : 64 . 5 , y:279.5 ), {x:393.5, y:421.5)); 

Rectangle 

The format for a rectangle is {? eft ; fl oat , top.-float, right: float, bottom: float). 
For instance, dom . addNewOval ( boundi ngRectangl e) could look like the following example: 

fw . getDocumentDOMl ) . addNewOval ( 1 1 eft : 72 , top:79, right:236, bottom:228) ) ; 

Resolution 

The format for resolution is I ptxe Jsfert/n? t; float, units: s t r i n g ). Acceptable values for 
units are "inch" or "cm". For instance, dom. set Document Resol uti on( resol uti on) could look 
like the following example: 

fw . getDocumentDOMl ). set Document Resolution({pixelsPerUnit:72, un its:" inch ")); 
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The Fireworks Object Model 



If you want to extend Fireworks by writing or modifying a JavaScript extensibility file, you must 
become familiar with the objects that Fireworks makes accessible through JavaScript. The 
following components comprise the Fireworks Object Model: 

• Five global methods that are available from any part of the application and need not be 
declared as methods of a particular object. These methods are described in “Global methods” 
on page 9. 

• Four core objects: Document, Errors, Files, and Fi nd. These objects and their properties and 
methods are described in detail in “Core objects” on page 9. (The App object that was used in 
Fireworks 3 is supported for backward compatibility, but its use is deprecated in favor of the 
Fi reworks object.) 

• The Fi reworks object, which is described in “The Fireworks object” on page 17. 

• Numerous objects are associated with Fireworks documents, such as ExportOpti ons. Guides, 
Path, Image, and Text. These objects and their properties are described in “Objects within 
Fireworks documents” on page 20. 

• A set of objects that you can use to specify the format of HTML source code when exporting 
from Fireworks. These are described in “HTML export objects” on page 44. 

How to use the Fireworks Object Model 

You send calls to the Fireworks Object Model to determine or change the current settings for a 
Fireworks document. For example, the following command returns the path to the Export 
Settings directory, which is expressed as a file://LlRL; fw references the Fireworks global object, of 
which appExportSettingsDi r is a property (see “The Fireworks object” on page 17). 

var expSetDir = fw. appExportSetti ngsDi r ; 

Accessing a Fireworks document 

All the functions listed in “Document functions” on page 58 are methods of the Document object, 
which is an object that represents a Fireworks document. To perform a function on a Document 
object, you must first get the Document Object Model (DOM) of the document. You then call 
the functions as methods of that DOM. 

Note: You can use methods that operate on a document’s DOM only on open documents. 
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• To use a DOM function with a document other than the active document, use the following 
syntax; note that documentindex is a zero-based integer that specifies which document the 
command will affect. 

fw . documents [document Jndex] . f uncti onName( ) ; 

• To use a DOM function with the active document, use 

fw . getDocumentDOM( ).functionName(), which is described next. 

fw.getDocumentDOMO 

Availability 

Fireworks 3 

Description 

Returns the Document object for the active document (see “Document” on page 9). After the 
object is returned, you can edit its properties to make changes to the document. 

Arguments 

None. 

Returns 

A Document object that represents the DOM of the active document. If there is no active 
document, returns null. 

Passing values 

For all properties that are not read-only, you can pass values to change elements of a document. 
For example, the following command sets the fifth brush in the third open document to a square 
shape: 

fw.documents[2] .brushes[4] .shape = "square"; 

The preceding example includes the following properties: 

• documents is a property of the Fi reworks object and contains an array of Document objects. 

• brushes is a property of the Document object and contains an array of Brush objects. 

• shape is a property of the Brush object. 

Note: Throughout this manual, optional arguments are enclosed in {braces}. 

Fireworks Object Model calls and API calls 

In some cases, you can use Fireworks Object Model calls or API calls to perform the same 
functions. In other cases, a certain function might be available in either the Fireworks Object 
Model or the API, but not in both. 

For example, if the first open document is the current document, the first code snippet has the 
same effect as the second and third code snippets. (As explained in “Accessing a Fireworks 
document” on page 7, fw. getDocumentDOM( ) references the current document.) 

fw . getDocumentDOM( ). set Document Resolution({pixelsPerUnit:72, units: "inch "I); 

fw . documents [0] . resol uti on =72; 

fw . documents [0] . resol uti onUni ts =" i nch" ; 
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Global methods 

The following table lists the global Fireworks methods, along with their data types and, where 
appropriate, acceptable values and notes. 



Method 



Data type Notes 



al ert ( message) 



conf 1 rni( message) 



prompt( capt 7on, text) 



wri te( argl, argZ argN) 



WRITE_HTML( argl. argZ argN) 



string Displays a string in a modal alert box, along with an 

OK button. Returns nothing. 

string Displays a string in a modal alert box, along with OK 

and Cancel buttons. Returns t rue if OK is clicked, 
f a 1 s e if Cancel is clicked. 

string, string Prompts the user (with the string that is specified by 
text) to enter a string in a modal dialog box; the 
dialog box is titled with the string that is specified by 
caption. Returns the string entered if OK is clicked, 
null if Cancel is clicked. 

string Sameas WRITE_HTML. WRITE_HTME was created to 

let you differentiate HTML output calls from other 
JavaScript calls in your code. 

string Available only when exporting. Converts each 

argument to a string and writes it to the HTML 
output file. To enter an end-of-line character, use 
" \ n " ; this is converted to the correct line ending for 
your platform. For more information, see “HTML 
export objects” on page 44. 



Core objects 

This section describes the four core objects that are always available: Document, Errors, 

Fi 1 es, and Fi nd. 

Note: For information on how to format nonstandard data types, such as rectangle or point, see “Formatting 
nonstandard data types” on page 5. 

Document 

The following table lists the properties and methods of the Document object, along with their data 
types and, where appropriate, acceptable values and notes. Read-only properties are marked with 
a bullet (•). You can also use many API calls to work with documents. For more information, see 
“Document functions” on page 58. 



Property 


Data type 


Notes 


backgroundCol or 


string 


A color string that specifies the document 
canvas color (see “Color string” on page 5). 


backgroundURE 


string 


Sets a general URL for a document that 
uses a hotspot. Everything that is not 
covered by the hotspot has the 
backgroundURL. 


brushes • 


array 


Array of B r u s h objects that are available for 
use in the document (see “Brush” on page 
21). 


currentFrameNuni 


zero-based integer 


The index of the current frame. 


currentEayerNuni 


zero-based integer 


The index of the current layer. 
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Property 



Data type 



Notes 



defaul tAl tText 


string 


Defauit Ait text for the output images, it 
works for singie and siiced images. Siiced 
images get the defauit, uniess specific text is 
specified for a siice. Corresponds to the text 
that is specified in Fiie > FHTML Properties > 
imageMap > AitimageDescription. 


docTi tl eWi thoutExtensi on 


string 


The titie of the document fiie, without any fiie 
extension, if the document has not been 
saved, this string is empty. 


exportFormatOptions 


object 


identicai to exportOpti ons. inciuded for 
backward compatibiiity with Fireworks 2. 


exportOpti ons 


object 


ExportOpti ons object (see 
“ExportOptions” on page 33). 


exportSetti ngs 


object 


ExportSetti ngs object (see 
“ExportSettings” on page 36). 


fi 1 ePathForRevert 


string 


The path to the fiie from which this 
document was opened, which is expressed 
asafiie://URL, omul 1 if created from 
scratch. 


fi 1 ePathForSave 


string 


The iocation to which this document was 
saved, which is expressed as a fiie://URL, or 
null if never saved. 


fills • 


array 


Array of F i 1 1 objects that are avaiiabie for 
use in the document (see “Fiii” on page 38). 


f rameCount 


integer 


The number of frames in the current 
document. 


f rameFoopi ngCount 


integer 


-1 - don’t repeat 

0 - repeat forever 

> 0 - repeat this number of times 


frames • 


array 


Array of F r a me objects in the document (see 
“Frame” on page 38). 


gammaPrevi ew 


Booiean 


if true, the document shouid be previewed 
in opposite-piatform gamma, if false, the 
document coiors are unadjusted. 


gradients • 


array 


Array of Gradi ent objects that are avaiiabie 
for use in the document (see “Gradient” on 
page 39). 


gri dCol or 


string 


A coior string that specifies the coior of the 
grid dispiay (see “Coior string” on page 5). 


gri dOri gi n 


point 


Used to set the origin of the grid. 
Corresponds to the point set when dragging 
the ruier-origin out from the upper ieft of the 
document when ruiers are visibie. 


gri dSi ze 


point 


gri dSl ze ,x is the horizontai grid size; 
gri dSi ze .y is the verticai grid size. 


guides • 


object 


Gui des object (see “Guides” on page 39). 
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Property 



Data type 



Notes 



height 


integer 


T otai height of the document, in pixels. T o 
find fhe bottom edge of the document, use 
document. 

top + document . hei ght . 


1 sDi rty 


Boolean 


true if the document was modified since the 
last time it was saved. 


isPaintMode • 


Boolean 


true if the document is currently in paint- 
mode editing, false otherwise. 


1 sSymbol Document • 


Boolean 


true if the document is a Symbol or Button 
document, fa 1 se if it is a normal document. 
You might see this when looking through the 
list of open documents and one is a symbol- 
editing window. 


1 s V a 1 1 d 


Boolean 


true if the document is open in Fireworks; 
fal se otherwise. (Occasionally the 
JavaScript object that is associated with a 
document lingers after the document closes; 
this property lets you check for that case.) 


lastExportDi rectory 


string 


The path to the last directory to which the file 
was exported, which is expressed as a file;// 
URL, or nul 1 if the file was never exported. 
For instance, if the document was last 
exported to''file:///files/current/ 

1 ogo . gi f ", it returns "file:///files/ 
current". 


1 astExportFi 1 e 


string 


The name that was used the last time the file 
was exported, or n u 1 1 if the file was never 
exported. For instance, if the document was 
last exported to "f 1 1 e : / //f i 1 es/ 
current/1 ogo . gi f ", it returns 
" 1 ogo .gif". 


layers • 


array 


An array of Eayer objects in the document 
(see “Layer” on page 40). 


1 eft 


integer 


Coordinate of the left edge of the document, 
in pixels. To find the right edge of the 
document, use document . 1 eft + 
document. width. 


mapType 


string 


Acceptable values are "client", 

"server", and "both". Corresponds to the 
image-map type selected in File > 

HTML Properties > ImageMap. 


matteCol or 


string 


A color string that corresponds to the matte 
color specified in the Optimize panel (see 
“Color string” on page 5). This string is used 
by the useMatteCol or property. 


oni onSki nAfter 


integer 


Number of frames after the current frame to 
show via onion skinning. Corresponds to the 
onion-skin controls in the left edge of the 
Frames panel. A value of 0 indicates no 
onion skinning; a very large value (such as 
99 , 999) indicates onion skinning of all 
frames after the current frame. 
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Property 


Data type 


Notes 


oni onSki nBefore 


integer 


Similar to oni onSki nAfter (above), but 
refers to number of frames to onion skin 
before the current frame. 


pathAttri butes 


object 


PathAttrs object (see “PathAttrs” on page 
40). This object specifies default attributes 
that will be applied to all newly created 
objects. 


pngText 


object 


A structure that can be used to store various 
chunks of text in a well-known format. For 
more information, see “Using the pngText 
object" on page 12. 


resol uti on 


float 


Document resolution, in pixels-per-unit (see 
resol uti onUnits). The range isl to 5000. 


resol uti onLIni ts 


string 


The units to be used with the resol uti on 
property. Acceptable values are "inch" 
and "cm". 


textures • 


array 


Array of Texture objects that are available 
for use in the document (see “Texture" on 
page 32). 


top 


integer 


Coordinate of the top edge of the dooument, 
in pixels. To find the bottom edge of the 
document, use 

document. top + document . hei ght . 


useMatteCol or 


Boolean 


If true, the matteCol or property is used 
when exporting documents with transparent 
backgrounds. If fal se, the matteCol or 
property is ignored in this situation, and the 
exported file is matted against the 
document’s canvas color. 


width 


integer 


The width of the document, in pixels. To find 
the right edge of the document, use 
document . 1 eft + document .width . 



Using the pngText object 

Fireworks maintains the following fields for use with the pngText object: 



Field name Value 

Great! onTi me The date and time the document was created. 

Software The software used to create the document. Fireworks always sets this value to 

Macromedia Fireworks MX. 



You can edit these or add your own fields, and they will be preserved across file saves. 

The pngText object corresponds directly to the 'tEXt' chunk of the document’s PNG structure. 

Errors 

All Errors properties are read-only strings that are used to make localizing scripts easier. They 
return localized error messages appropriate to the specific error. For example, the English version 
of Fireworks returns "Memory i s ful 1 . " for the EOutOfMem property. 
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The following example shows an alphabetical list of the properties of the Errors object: 

EAppAl ready Runni ng , EApp Not Seri al i zed , EAr ray I ndexOutOf Bounds , 

EBadFi 1 eContents , EBadJsVersi on , EBadNesting, EBadParam, EBadParaniType , 
EBadSel ecti on , EBufferTooSmal 1 , ECharConversi onFai 1 ed , EDatabaseError , 

EDel eti ngLastMasterChi 1 d , EDiskFull, EDupl i cateFi 1 eName , EFi 1 elsReadOnl y , 
EFileNotFound, EGenericErrorOccurred, EGroupDepth, EIllegalThreadAccess, 
EInternal Error , ELowOnMem, ENoActi veDocument , ENoFi 1 esSel ected , 
ENoNestedMastersOrAliases, ENoNestedPasting, ENoSliceableEl ems , 

ENoSuchEl ement, ENotlmpl emented , ENotMyType, EOutOfMem, EResourceNotFound , 
EShari ngViol ati on , EUnknownReaderFormat , EUserCancel ed , EUserlnterrupted , 
EWrongType 

Files 

The following table lists the methods of the Files object, along with their data types and, where 
appropriate, acceptable values and notes. 



Method 



Data type Notes 



closet) none 

copy ( docnamei, docname2) string, string 

createDi rectory! di rname) string 

createFi 1 e( f 7 /et/fft, IwacType string, string, 

I .macCreatorl I) string 

del eteFi 1 e( docOrOir) string 

del eteFi 1 elf Existing (docOrOir) string 
enumFi 1 es ( docOrOf r) string 

exi sts ( docOrDir) string 



Cioses the fiie referred to by this Ft 1 es object. You 
are not required to call this (the file is closed when 
the Files object is destroyed), but it is useful for 
controlling the access to a file. 

Copies the file specified in the first argument to the 
file specified in the second argument. Each 
argument must be which is expressed as a file:// 
URL. Only files (not directories) can be copied. The 
files do not need to reside on the same drive, and 
the method does not overwrite a file if it already 
exists. Returns true if the copy is successful; 
fal se otherwise. 

Creates the specified directory. Returns true if 
successful; false otherwise. 

Creates the specified file. The file must not already 
exist. The first argument is the name of the file 
which is expressed as a file://URL. The last two 
optional arguments let you specify the Macintosh 
file type and file creator strings. If used, the 
macType and /tracCrea tor strings should each be 
strings of exactly four characters in length. 

Deletes the specified file or directory. Returns true 
if successful; f a 1 s e if the file or directory does not 
exist or cannot be deleted. Compare with 
del eteFt 1 elf Existtngt ). 

Deletes the specified file or directory. Returns true 
if successful; false if the file or directory cannot be 
deleted. Unlike del eteFi 1 e( ), this method returns 
true if the file or directory does not exist. 

Returns an array of file URLs. If docOrOi r is a 
directory, the array contains an entry for every file or 
directory that is contained in the specified directory. 
If docOrO 7 r is a file, the array contains a single entry 
(the file passed in). 

Returns true if docOrD 7 r refers to a directory or 
file that exists; fal se otherwise. 
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Method 



Data type 



Notes 



getDi rectory( docnarae) string 



getExtensi on ( docrtarae) string 



getFi 1 ename( docnarae) string 



getLastErrorStringt ) none 



getTempEi 1 ePath i {di rnamel) string 



isDi rectory ( dr rnarae) string 



makePathEromDi r And Ft 1 e( d1 rname. string, string 

p] a inFi 1 ename) 



Returns only the direotory name from docname, 
which must be which is expressed as a file://URL. 
For example, Ft 1 es . getDi rectory ( "f i 1 e : / / 
work/1 ogo . png" ) returns "f i 1 e : ///work". 

Returns the filename extension, if any, of docname. 
For example, 

Files.getExtens font "birthday. png") returns 
" . png". If the filename has no extension, an empty 
string returns. A filename that is expressed as a file:/ 
/URL is acceptable. 

Returns just the filename from docname, which 
must be which is expressed as a file://URL. For 
example, Fi 1 es . getFf 1 enamel "f i 1 e : / //work/ 

1 ogo . png" ) returns " 1 ogo . png". 

If the last call to a method in a Ff 1 es object resulted 
in an error, returns a string that describes the error. If 
the last call succeeded, returns null. 

The argument, if used, must be expressed as a file:// 
URL. Returns a file URL in the Temporary Files 
directory or in the specified directory. This method 
does not create a file; it simply returns a unique 
file URL that does not conflict with existing files in 
the directory. If di rname is passed and is not null, 
the URL that returns indicates a file in the specified 
directory rather than in the Temporary Files 
directory. 

The argument must be expressed as a file://URL. 
Returns true if the specified URL refers to a 
directory that exists; fal se otherwise. 

The first argument must be expressed as a file:// 
URL. Concatenates the two arguments to return a 
file URL that references the specified filename in 
the specified directory. For example, 

Fi 1 es .makePathFromDf rAndFi 1 e{ "f i 1 e : /// 
won k/ reports " , "1 ogo . png" ) returns "file:/ 
//work/reports/logo.png". 



open ( docname, bklri te) string. Boolean The first argument must be expressed as a file:// 

URL. Opens the specified file for reading or writing. 
If the second argument is true, the file opens for 
writing: otherwise it opens for reading. If the file 
cannot be opened, returns null; otherwise, returns 
a Fi 1 es object. 

readlinel) none Readsthenextiinefromthefilethatisreferredtoby 

the current Fi 1 es object and returns it as a string. 
The end-of-line character(s) are not included in the 
string. Returns null if end-of-file is reached or if 
the line is more than 2048 characters. 



rename! docname, newPl a inFi 1 ename) string, string docname is a file path or a file URL to the file that 

you want to rename. 

newPl ai nFi ] ename is the new name to assign to 
the file. 

The rename method returns a URL path of the 
newly renamed file if successful: otherwise 
Fireworks returns null. 



14 Chapter 2 




Method 


Data type 


Notes 


setFi 1 ename( docname. 
newP] ai nFi lenanie) 


string, string 


The first argument must be expressed as a file:// 
URL. Returns a file URL with docname replaced by 
neuPl ai nFi iename. For example, 
Files.setFilenamef "file:/// work/ 

1 ogo . png" , "ol dl ogo . png" ) returns "f i 1 e : / / 
/work/oldlogo. png". This method does not 
affect the file on disk; it simply provides a 
convenient way to manipulate file URLs. To change 
the name on disk, use rename ( ). 


swap( docnamel. docnameP) 


string, string 


Each argument must be expressed as a file://URL. 
Swaps the contents of the two specified files, so 
that each file contains the contents of the other file. 
Only files (not directories) can be swapped, and 
both files must reside on the same drive. Returns 
true if the swap is successful; false otherwise. 


wri te( textstring) 


string 


Writes the specified string to the file that is referred 
to by the current Files object. No end-of-line 
characters are appended: to include one, use " \ n " . 



Find 

There are several ways to specify a F1 nd object, depending on what you want to find and replace. 
Use the whatToFi nd property to specify the type of find operation, along with the properties that 
are associated with each legal value for whatToFi nd. These properties are listed in the following 
tables. Read-only properties are marked with a bullet (•). 



To find and replace text 



Property 


Data type 


Notes 


whatfoFi nd 


string 


"text" 


f i nd 


string 


Text to find. 


matchCase 


Boolean 


If t rue, the search is case-sensitive. Defaults to 
fal se. 


regExp 


Boolean 


If true, the f i nd and repl ace text is interpreted as 
a Regular Expression. Defaults to false. 


repl ace 


string 


Text to use as replacement text. 


whol eWord 


Boolean 


If true, only whole words matching the search text 
are found. Defaults to fal se. 
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To find and replace fonts and styles 



Property 


Data type 


Notes 


whatToFi nd 


string 


"font" 


ft nd 


string 


Name of font to find. 


repl ace 


string 


Name of font to use as repiacement. 


ft ndStyl e 


integer 


Number that represents the style to find: 

AnyStyle = -1 

Plain = 0 

Bold = 1 

Italic = 2 

Bol dl tal i c = 3 

Underline = 4 

Bol dUnderl i ne = 5 

ItalicUnderline = 6 

Bol dl tal i cUnderl i ne = 7 


repl aceStyl e 


integer 


Number that represents the style to be used as 
replacement. 


ft ndMi nSi ze 


integer 


0 to 9999 


ft ndMaxSi ze 


integer 


0 to 9999 


repl aceSi ze 


integer 


0 to 9999, or pass - 1 to leave size as is 



To find and replace colors, fills, strokes, and effects 



Property 


Data type 


Notes 


whatToFi nd 


string 


"col or" 


f i nd 


string 


A color string that specifies the color to find (see 
“Color string” on page 5). 


repl ace 


string 


A color string that specifies the color to use as a 
replacement (see “Color string” on page 5). 


fills 


Boolean 


If true, fills that match the specified colors are 
replaced. 


strokes 


Boolean 


If true, strokes that match the specified colors are 
replaced. 


effects 


Boolean 


If true, effects that match the specified colors are 
replaced. 


To find and replace URLs 


Property 


Data type 


Notes 


whatfoFi nd 


string 


" u r 1 " 


find 


string 


URL to find, which is expressed as a file://URL. 


repl ace 


string 


URL to use as replacement text, which is 
expressed as a file://URL. 


whol eWord 


Boolean 


If true, only whole words that match the search 



text are found. Defaults to fal se. 
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Property 



Notes 



Data type 



matchCase 


Boolean 


If true, the search is case-sensitive. Defaults to 
fal se. 


regExp 


Boolean 


If true, the f i nd and repl ace text is interpreted as 
a Regular Expression. Defaults to false. 



To find and replace nonwebsafe colors with the closest websafe color 



Property 


Data type 


Notes 


whatToFi nd 


string 


"nonwebcol or" 


effects 


Boolean 


If true, colors in effects are replaced. Default value 
is fal se. 


fills 


Boolean 


If true, colors in fills are replaced. Default value is 
fal se. 


strokes 


Boolean 


If true, colors in strokes are replaced. Default value 
is fal se. 



The Fireworks object 

The Fi reworks object is the global object, which you can use to set or retrieve properties that 
relate to the current operating environment. (The App object that was used in Fireworks 3 is 
supported for backward compatibility, but its use is deprecated in favor of the Fi reworks object.) 

The following table lists the properties and methods of the Fi reworks object, along with their 
data types and, where appropriate, acceptable values and notes. Read-only properties are marked 
with a bullet (•). 

Note: For information on howto format nonstandard datatypes, such as rectangie or point, see “Formatting 
nonstandard data types” on page 5. 

Refer to the Fireworks object by using fw . propertyName or f i reworks . propertyName. Note 
that fi reworks must be lowercase. 



Property or Method 


Data type 


Notes 


act! veVi ewScal e 


float 


The scaling (zoom value) of the active view. 
1.0=100% of the normal view. 


appBatchCodeDi r • 


string 


The path to the Batch Code directory, which is 
expressed as a file://URL. 


appDir • 


string 


The path to the directory that contains 

the Fireworks application, which is expressed as a 

file://URL. 


appExportSetti ngsDi r • 


string 


The path to the Export Settings directory, which is 
expressed as a file://URL. 

In Eireworks MX, this folder is stored on a per-user 
basis on multiuser systems. Even on single-user 
systems, this folder is not inside the Eireworks 
installation directory. 
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Property or Method 



Data type 



Notes 



appFavori tesDi r • 


string 


The path to the URL Libraries directory, which is 
expressed as a file://URL. 

In Fireworks MX, this folder is stored on a per-user 
basis on multiuser systems. Even on single-user 
systems, this folder is not inside the Fireworks 
installation directory. 


appHelpDir • 


string 


The path to the directory that contains 

the Fireworks help file, which is expressed as a file:/ 

/URL. 


appHtml CodeDi r • 


string 


The path to the FITML Code directory, which is 
expressed as a file;//URL. 


appJsCommandsDi r • 


string 


The path to the Commands directory, which is 
expressed as a file;//URL. 


appJsExtensionsDi r • 


string 


The path to the JSExtensions directory, which is 
expressed as a file://URL. 


appMacCreator • 


string 


"MKBY" 


appMacJsf Fi 1 eType • 


string 


"TEXT" 


appName • 


string 


The name of the application (" Fi reworks MX"). 



This attribute is part of the common API, so it also 
appears as app . appName (as implemented in 
Dreamweaver). 



appPatternsDi r • 


string 


The path to the Patterns directory, which is 
expressed as a file;//URL. 


appPrefsDi r 


string 


The path to the Preferences directory, which is 
expressed as a file;//URL. 


appPresetsDi r • 


string 


The path to the Presets directory, which is 
expressed as a file://URL. 

In Fireworks MX, this folder is stored on a per-user 
basis on multiuser systems. Even on single-user 
systems, this folder is not inside the Fireworks 
installation directory. 


appSetti ngsDi r • 


string 


The path to the Settings directory, which is 
expressed as a file://URL. 


appStylesDir • 


string 


The path to the Styles directory, which is expressed 
asafile://URL. 

In Fireworks MX, this folder is stored on a per-user 
basis on multiuser systems. Even on single-user 
systems, this folder is not inside the Fireworks 
installation directory. 


appSwTCommandsDi r 


string 


The path to the SWF Commands directory, which 
is expressed as a file://URL. 


appSymbol LibrariesDi r • 


string 


The path to the Libraries directory, which is 
expressed as a file://URL. 


appTexturesDi r • 


string 


The path to the T extures directory, which is 
expressed as a file;//URL. 


appXtrasDir • 


string 


The path to the Xtras directory, which is expressed 



asafile://URL 
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Property or Method Data type Notes 



batchStatusStri ng 


string 


The string that currently appears in the Batch 
Progress dialog box. Set this property to change 
the string being displayed. Use with 
progressCountCurrent and 
progressCountTotal. 


currentScri ptDi r 


string 


The path to the directory of the currently running 
script, which is expressed as a file://URL (or could 
be nul 1 ). 

This path goes to the directory in which the script 
resides, not a full file path to the script itself (it 
excludes the script's filename). 


currentScriptFileName 


string 


The filename of the currently running script (or 
could be nul 1). 

This name is the script’s filename, not the full path. 


documentLi St • 


array 


Array of the current open Document objects (see 
“Document” on page 9). If no document is open, it 
returns an array of length zero. 


documents • 


array 


Array of the current open Document objects (see 
“Document” on page 9). If no document is open, 
returns an array of length zero. 


hi storyPal ette • 


object 


History panel object. There are no DOM 
properties for the History panel, only API calls. For 
more information, see “History panel functions” on 
page 197. 


platform • 


string 


The string "mac" if Fireworks is running on the 
Macintosh, or "w1 n " if running on Windows. 


progressCountCurrent 


integer 


The first number (x) that appears in the Batch 
Progress dialog box, in the “File x of y” field. Set this 
property to change the number. 


progressCountTotal 


integer 


The second number (y) that appears in the Batch 
Progress dialog box, in the “File x of y” field. Set this 
property to change the number. 


screenRect • 


rectangle 


The size of the main screen on this computer, in 
pixels. Useful for positioning windows or panels. 


sel ecti on 


array 


Array of the selected objects in the active 
document. If nothing is selected, it returns an array 
of length zero. If no document is open, it returns 
null. 


sel ectedMask 


object 


If a single item is selected and that item is a mask, 
this property returns an El ementMask (see 
“ElementMask” on page 32): otherwise it returns 
null. 


styles • 


array 


Array of the Styl e object that is currently loaded in 
the Style panel (see “Style” on page 41). 


textOutputEncoding 


string 


The default text encoding for any text file that the 
JavaScript interpreter generates. 

Use "i so-8859 1" for ASCII or "utf-8" for 
Unicode. 
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Property or Method 


Data type 


Notes 


userJsCommandsDf r 


string 


The path to the user-level Commands directory, 
which is expressed as a file://URL. 

In Fireworks MX, this folder is stored on a per-user 
basis on multiuser systems. Even on single-user 
systems, this folder is not inside the Fireworks 
installation directory. 


userSwfCommandsDi r 


string 


The path to the user-level SWF Commands 
directory, which is expressed as a file://URL 
In Fireworks MX, this folder is stored on a per-user 
basis on multiuser systems. Even on single-user 
systems, this folder is not inside the Eireworks 
installation directory. 


xhtml Format 


Boolean 


Determines whether the JavaScript interpreter 
should output XFITML formatted files or FITML 
formatted files; XFITML (true) or FITML (fal se). 



Using fw.locateDocDialogO 

The forma t Array argument of the locateDocDialog( ) method is an array of strings such as the 
ones shown in the following example: 

[ ''formatnamel '' , "formatname2" , "formatnameS" ...."formatnameN" ] 

The following table lists acceptable values for f ormatname and the file type each value represents. 



Value 


File type 


"ADOBE AI3" 


Adobe Illustrator 


"Fireworks JavaScript" 


Fireworks JSF 


" kMoaCf Forma t_BMP" 


bitmap 


" kMoaCf Format_FreeHand7and8" 


Macromedia FreeFland 7 or 8 


" kMoaCf Format_GI F" 


GIF 


" kMoaCf Forma t_J PEG" 


JPEG 


" kMoaCf Forma t_P I CT" 


Macintosh PICT 


" kMoaCf Forma t_RTF" 


Rich Text 


"kMoaCf Forma t_Text" 


Plain text 


" kMoaCf Forma t_T I FF" 


TIFF 


"PNG" 


PNG 


"PS30" 


Photoshop PSD 



Objects within Fireworks documents 

This section describes the objects that provide access to elements within a Fireworks document. 
For syntax on accessing Fireworks documents and elements within them, see “Accessing a 
Fireworks document” on page 7 and “Passing values” on page 8. 

Note: For information on how to format nonstandard data types, such as rectangie or point, see “Formatting 
nonstandard data types” on page 5. 
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Behavior 



The following table lists the properties of the Behavior object, along with their data types and, 
where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


cal 1 


string 


The JavaScript call for the behavior. For legal 
values, see “Using the addBehavior() function” on 
page 201. 


event 


string 


Acceptable values are "onMouseOver". 
"onClick", "onMouseOut", "onload", and 
"**ANY**" (the **ANY** argument is used as a 
wildcard value in some situations). 



Brush 

The following table lists the properties of the Brush object, along with their data types and, where 
appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


al phaRemap 


string 


Acceptable values are "none", "whi te neon", 
"harsh wet", "smooth neon", "wavy gravy", 
and "white neon edge". 


angle 


integer 


0 to 360 


anti Al i ased 


Boolean 


If t rue, the brush edges are anti-aliased. 


aspect 


float 


0 to 100 


bl ackness 


float 


0 to 100 


category 


string 


Determines in which subsection of the Stroke panel 
the brush will appear (for example. Pencil, Airbrush, 
and so on). 


concentrati on 


float 


0 to 100 


di ameter 


integer 


0 to 1000 


feedback 


string 


Acceptable values are "none", "brush", and 
"background". 


f 1 owRate 


float 


0 to 100 


maxCount 


integer 


0 to 64 


mi nSi ze 


float 


0 to 100 


name 


string 


The name of the brush, which is visible in the Stroke 
panel. 


sensi ti vi ty_x_y 


integer 


0 to 100, wherexisavalueof pressure, speed, 
hDir, vDir, random; and j/ is a value of: si ze , 
angle, opacity, blackness, scatter, 
hue, lightness, saturation. For example, 
sensi ti vi ty_pressure_si ze. 


shape 


string 


Acceptable values are "circle" and "square". 


softenMode 


string 


Acceptable values are "bell curve" and 
"linear". 


softness 


float 


0 to 100 
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Property 


Data type 


Notes 


spacing 


float 


0 to 500 (a percentage, as much as 500 percent) 


textureBl end 


float 


0 to 100 


textureEdge 


float 


0 to 100 


ti pCol ori ng 


string 


Acceptable values are "random", "uniform", 
"compl ementary ", "hue", and "shadow". 


ti pCount 


integer 


Ito 32 


ti pSpaci ng 


float 


0 to 100 


ti pSpaci ngMode 


string 


Acceptable values are " random", "di agonal ", 
and "ci rcul ar". 


type 


string 


Acceptable values are "natural " and "si mpl e". 


Contour 






The following table lists the properties of the Contour object, along with their data types and, 
where appropriate, acceptable values and notes. 


Property 


Data type 


Notes 


i sCl osed 


Boolean 


If t rue, the path is closed by connecting the final 
point in the contour with the first point. 


nodes 


array 


Array of ContourNode objects on the contour (see 
ContourNode). 


ContourNode 






The following table lists the properties of the ContourNode object, along with their data types 
and, where appropriate, acceptable values and notes. 


Property 


Data type 


Notes 


dynanii cinfo 


array 


Array of ContourNodeDynami cinfo objects on 
this ContourNode object (see 
“ContourNodeDynamicInfo” on page 23). 


i sCurvePoi nt 


Boolean 


If t r u e, this point’s control points are constrained to 
be linear with the main point, which forces a smooth 
curve. If f al se, there are no constraints on the 
control points. 


i sSel ectedPoi nt 


Boolean 


If true, this point was subselected (for example, by 
the subselection tool). 


predX 


float 


The X coordinate of the contour node’s preceding 
control point. 


predY 


float 


They coordinate of the contour node’s preceding 
control point. 


randomSeed 


integer 


0 to 65,535 


succX 


float 


The X coordinate of the contour node’s following 
control point. 


succY 


float 


They coordinate of the contour node’s following 



control point. 
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Property 


Data type 


Notes 


X 


float 


The a: coordinate of the contour node’s main control 
point. 


y 


float 


The j/ coordinate of the contour node’s main control 
point. 


ContourNodeDynamicInfo 






The following table lists the properties of the ContourNodeDynami cinfo object, along with their 
data types and, where appropriate, acceptable values and notes. 


Property 


Data type 


Notes 


durati on 


float 


0.0 to 65,535.0 milliseconds 


pressure 


float 


0.0 to 1.0 


vel oci ty 


float 


0.0 to 255.9999 pixels-per-millisecond 



Effect 

Each Effect object has a different set of properties because every effect has different attributes 
that can be set. The properties for various Effect objects are listed in the following tables, in 
alphabetical order. 

Note: In addition to the listed properties, each Effect object has two optional string properties: 
category and name. 

Bevel 

Use the Bevel Type property of this effect to set a bevel as inner, outer, raised embossed, inset 
embossed, or glow effect. 



Property 


Data type 


Notes 


Angl eSoftness 


integer 


Specifies the blur, or feather amount, for the 
shadow and highlight colors of the bevel. 


Bevel Contrast 


integer 


0 to 100 percent 


Bevel Type 


integer 


InnerBevel = 0 
OuterBevel = 1 
Raf seEmboss = 2 
InsetEmboss = 3 
G1 owEffect = 4 


Bevel Wi dth 


integer 


The width of the bevel, in pixels. 


ButtonState 


integer 


Bevel ButtonUp = 0 
Bevel ButtonOver = 1 
Bevel ButtonDown = 2 
Bevel ButtonHf t = 3 


DownBl endCol or 


string 


A color string that specifies the color that is blended 
on top of the image if ButtonState = 2 
(BevelButtonDown)(see “Color string” on page 5). 


EdgeThreshol d 


integer 


Controls the opacity at which the edge of the effect 
is defined. Use 1 if Bevel Type = 4 (for 
GlowEffect); otherwise, use 0. 
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Property 


Data type 


Notes 


EffectlsVi sibl e 


Boolean 


If f al se, the effect is included but temporarily 
hidden. Default value is t rue. 


EffectMoalD 


string 


" I7fe61102-6ce2-lldl-8c76000502701850l " 


EmbossEaceCol or 


string 


A color string that specifies the color that is blended 
onto the face of the object when embossing (see 
“Color string” on page 5). 


G1 owStartDi stance 


integer 


Specifies how far away from the object the glow 
starts, in pixels. Specify a negative value to create 
“ring” type glows and a positive value to create 
“halo” type glows. 


G1 owWi dth 


integer 


The width of the glow, in pixels. 


Hi 1 i teCol or 


string 


A color string that specifies the color that is blended 
to provide the spectral lighting type effect (see 
“Color string” on page 5). Used by beveling only. 
Currently white is always used for internally created 
effects (although any value should work). This is the 
complement of ShadowCol or. 


Hi tBl endCol or 


string 


A color string that specifies the color that is blended 
on theface of the image if ButtonState = 3 
(BevelButtonHit) (see “Color string” on page 5). 


Ei ghtAngl e 


integer 


The light angle, in degrees, that is used to create the 
light and shadow effects for the bevel. 


MaskSoftness 


integer 


The feather amount on the glow edge, in pixels. 


OuterBevel Col or 


string 


A color string that specifies the color of the outer 
bevel effect (see “Color string” on page 5). 


ShadowCol or 


string 


A color string that specifies the color that is blended 
to provide the bevel shadow effect (see “Color 
string” on page 5). Currently black is always used 
for internally created effects (though any value 
should work). This is the complement of 
Hi 1 1 teCol or. 


ShowObject 


Boolean 


Default value is false. 


SI opeMul ti pi i er 


float 


A multiplier that is used to calculate the magnitude 
of the bevel slope. Default effects all use 1, but other 
values should work. For example, 0.5 gives a more 
subtle slope and 2.0 gives a sharper slope. 


SI opeType 


integer 


f 1 at si ope = 0 
smooth slope = 1 
inverted smooth slope = 2 
frame 1 slope = 3 
frame 2 slope = 4 
ring slope = 5 
ruffl e si ope = 6 
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Blur 



Property 


Data type 


Notes 


EffectMoalD 


string 


"Iflcfce41-718e-lldl-8c8200a024cdc039l " 


EffectlsVi sibl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


Blur More 


Property 


Data type 


Notes 


EffectlsVi si bl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


EffectMoalD 


string 


"Iflcfce42-718e-lldl-8c8200a024cdc039l " 


Brightness/Contrast 


Property 


Data type 


Notes 


bri ghtness_amount 


integer 


-100 to 100 


contrast_amount 


integer 


-100 to 100 


EffectlsVi si bl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


EffectMoalD 


string 


" I3439b08c-1921-lld3-9bde00e02910d580l " 


Convert to Alpha 


Property 


Data type 


Notes 


EffectlsVi si bl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


EffectMoalD 


string 


" 1 2932d5a2 -ca48- lldl -8561000502701850 1 " 


Curves 


Property 


Data type 


Notes 


EffectlsVi si bl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


EffectMoalD 


string 


"(3439b08e-1923-lld3"- 
9bde00e02910d580l " 


rgb_poi nts 
red_poi nts 


vector of points 


Each of these properties is a vector of points where 
x= input level andj/ = output level. All xandj/ values 
must be between 0 and 255, and the points must 
be sorted in ascending order of x coordinate. 


green_poi nts 


bl ue_poi nts 
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Drop Shadow 



Property 


Data type 


Notes 


EffectlsVi si bl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is true. 


EffectMoalD 


string 


" Ia7944db8-6ce2-lldl-8c76000502701850l" 


ShadowAngl e 


float 


The angle of the shadow, in degrees. 


ShadowBl ur 


integer 


The feathering amount of the shadow edges, in 
pixels. 


ShadowCol or 


string 


A color string that specifies the color of the shadow 
(see “Color string” on page 5). 


ShadowDi stance 


integer 


The offset of the shadow, in pixels. 


ShadowType 


integer 


0 = normal shadow 

1 = knockout shadow 


Find Edges 


Property 


Data type 


Notes 


EffectlsVi sibl e 


Boolean 


If f al se, the effect is included but temporarily 
hidden. Default value is t rue. 


EffectMoalD 


string 


" Ifc7093fl-f95c-lld0-8be200a024cdc039l " 


Gaussian Blur 


Property 


Data type 


Notes 


EffectlsVi sibl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


EffectMoalD 


string 


" Id04ef8c0-71b3-lldl-8c8200a024cdc039l " 


gaussi an_bl ur_radi us 


fioat 


0.1 to 250 


Hue/Saturation 


Property 


Data type 


Notes 


EffectlsVi si bl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is t rue. 


EffectMoalD 


string 


" I3439b08d- 1922-1 ld3- 9bde00e02910d580 1 " 


hue_amount 


integer 


-180 to 180 if hi s_col orizeisfalse;Oto 360 if 
hi s_col ori ze is true. 


saturati on_amount 


integer 


-100 to 100 if hi s_col ori ze is fal se; 0 to 100 if 
hi s_col ori ze is true. 


1 i ghtness_amount 


integer 


0 to 100 


hi s_col ori ze 


Boolean 


Specifies whether the effect should automatically 
colorize. Default value is false. 
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Inner Shadow 



Property 


Data type 


Notes 


EffectlsVi si bl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is t rue. 


EffectMoalD 


string 


" I5600f702-774c-lld3-baad0000861f4d01 1 " 


ShadowAngl e 


integer 


The angle of the shadow, in degrees. 


ShadowBl ur 


integer 


The feathering amount of the shadow edges, in 
pixels. 


ShadowCol or 


string 


A color string that specifies the color of the shadow 
(see “Color string” on page 5). 


ShadowDi stance 


integer 


The offset of the shadow, in pixels. 


ShadowType 


integer 


0 = normal shadow 

1 = knockout shadow 


Invert 


Property 


Data type 


Notes 


EffectMoalD 


string 


"Id2541291-70d6-lldl-8c8000a024cdc039l " 


EffectlsVi si bl e 


Boolean 


If fal se, the effect is included but temporarily 
hidden. Default value is true. 


Levels 


Property 


Data type 


Notes 


EffectMoalD 


string 


" Id04ef8cl-71b4-lldl-8c8200a024cdc039l" 


EffectlsVi si bl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is true. 


source_l ow_rgb 


integer 


These values are all input levels to the filter, with 



values of 0 to 255. 

source_hi gh_rgb 
source_l ow_red 
source_hi gh_red 
source_l ow_green 
source_hi gh_green 
source_l ow_bl ue 
source_hi gh_bl ue 
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Property 


Data type 


Notes 


dest_l ow_rgb 


integer 


These values are all output levels to the filter, with 


dest_hi gh_rgb 




values of 0 to 255. 


dest_l ow_red 






dest_hi gh_red 






dest_l ow_green 






dest_hi gh_green 






dest_l ow_bl ue 






dest_hi gh_bl ue 






gamma_rgb 


float 


These values are all gamma levels to the filter, with 


gamma_red 




values of 0.1 to 10.0. 


gamma_green 






gamma_bl ue 






Sharpen 


Property 


Data type 


Notes 


EffectMoalD 


string 


" Ic20952bl-fc76-lld0-8be700a024cdc039l" 


EffectlsVi sibl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is true. 


Sharpen More 


Property 


Data type 


Notes 


EffectMoalD 


string 


" 1 If2f2591-9db7-lldl-8cad00a024cdc039l " 


EffectlsVi sibl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is t rue. 


Unsharp Mask 


Property 


Data type 


Notes 


EffectMoalD 


string 


" Iflcfce44-718e-lldl-8c8200a024cdc039l " 


EffectlsVi si bl e 


Boolean 


If false, the effect is included but temporarily 
hidden. Default value is t rue. 


unsharp_mask_amount 


integer 


1 to 500 


unsharp_mask_radi us 


float 


0.1 to 250 


unsharp_mask_threshol d 


integer 


0 to 255 
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EffectList 



The following table lists the properties of the EffectList object, along with their data types and, 
where appropriate, acceptable values and notes. 



Property 




Data type 


Notes 


category 




string 


Specifies which subheading in the Effects panel to 
use. 


effects 




array 


Array of Effect objects (see “Effect” on page 23). 


name 




string 


The name that appears in the Effects panet 


Element 








El ement is an abstract or base class; nothing of class El ement ever exists. However, it is useful for 
simplifying the other class descriptions. Read-only properties are marked with a bullet (•). 


Property 




Data type 


Notes 


bl endMode 




string 


Acceptable values are "normal ", "mul ti ply ", 
"screen", "darken", "lighten", 

"difference", "hue", "saturation", "color", 
" 1 umi nosi ty ", "invert", "tint", and "erase". 


eff ectLi St 




object 


Eff ectLi St object (see “EffectList” on page 29). 


height • 




float 


Read-only in the base class; other properties or API 
calls are used to resize specific types of elements. 


1 eft 




float 


Can round to an integer. 


mask 




object 


El ementMask object (see “ElementMask” on page 
32). Returns null if the element has no element 
mask. 


name 




string 


Can be nul 1 (removes any existing name). 


opaci ty 




float 


Acceptable values, 0 to 100, represent percent 
opacity. 


top 




float 


Can round to an integer. 


visible 




Boolean 


If false, the element is hidden. Default value is 
true. 


width • 




float 


Read-only in the base class; other properties or API 
calls are used to resize specific types of elements. 


Group 








Group is a subclass of the base class El ement and 
those in El ement (see “Element” on page 29). 


contains the following properties in addition to 


Property 




Data type 


Notes 


el ements 




array 


Array of El ement objects in the group (see 
“Element” on page 29). 


groupType 




string 


Aoceptable value is "normal " . ("mask to 
image" and "mask to path" are deprecated in 
Fireworks MX.) 
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Image 

Image is a subclass of the base class El ement (see “Element” on page 29). It contains no properties 
or methods other than those in El ement. 

Instance 

Instance is a subclass of the base class El ement and contains the following properties in 
addition to those in El ement (see “Element” on page 29). Read-only properties are marked 
with a bullet (•). 



Property 


Data type 


Notes 


al tText 


string 


The aiternate text description. 


instanceType • 


string 


The type of Eiement, for example "graphic", 
"button", or "animat! on" . 


symbol ID • 


string 


An arbitrary string that uniguely identifies the 
symbol that owns this instance. 


targetText 


string 


The target. 


transformMode 


string 


Acceptabie values are "paths" and "pixels". 


url Text 


string 


The linktext. 



Hotspot 

A Hotspot generates an image map during HTML export. Hotspot is a subclass of the base 
class El ement and contains the following properties in addition to those in El ement (see 
“Element” on page 29). 



Property 


Data type 


Notes 


al tText 


string 


Text that is written into the HTML Alt tag when 
exporting. 


behavi ors 


array 


Array of Behavi or objects for the hotspot 
“Behavior” on page 21. 


col or 


string 


Color in which the hotspot is drawn in the document 
window. Default value is "#OOFFFF". 


contour 


object 


Contour object forthe hotspot “Contour” on page 
22. Used only if shape="polyl i ne"; otherwise 
null. 


shape 


string 


Acceptable values are " rectangl e" , "ci rcl e", 
and "polyl ine". 


targetText 


string 


T ext that is written into the HTML T arget tag 
when exporting. 


url Text 


string 


T ext that is written into the HTML Href tag 
when exporting. 
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SliceHotspot 

ASliceHotspot generates an image slice during HTML export. SliceHotspot is a subclass of 
the base class Hotspot and contains the following properties in addition to those in Hotspot (see 
“Hotspot” on page 30). Read-only properties are marked with a bullet (•). 



Property 


Data type 


Notes 


baseName 


string 


Base name for slice fiienames, or n u 1 1 for 
automatic name. 


exportOpti ons 


object 


ExportOpti ons object (see “ExportOptions” on 
page 33); null if using current document defaults. 


htnil Text 


string 


If si i ceKi nd is "empty", this text is exported 
instead of the image. The default is an empty string. 


si ice ID • 


string 


An arbitrary string that uniquely identifies this slice. 


si i ceKi nd 


string 


"image" generates an image; "empty" generates 
the text that is specified by html Text. 


tdTagText 


string 


This string contains all the attributes of a table cell 
except the col span and rowspan values. 

An example value is "bgcol or=ft0000" 
val i gn="top" ". 


Path 


Path is a subclass of the base class El erne nt and contains the following properties in addition to 
those in El ement (see “Element” on page 29). 


Property 


Data type 


Notes 


contours 


array 


Array of Contour objects on this Path object (see 
“Contour” on page 22). 


pathAttri butes 


object 


PathAttrs object (see “PathAttrs” on page 40). 


randSeed 


float 


A 32-bit integer. JavaScript integers hold only 31- 
bit numbers, so it is stored as a floating-point 
number. 


textureOff set 


point 


If the path has a textured brush or fill, specifies the 
offset of the texture’s origin. 


Text 


Text is a subclass of the base class El ement and contains the following properties in addition to 
those in El ement (see “Element” on page 29). 


Property 


Data type 


Notes 


anti A1 i ased 


Boolean 


If true (the default), it anti-aliases the text. 


anti A1 i asMode 


string 


Acceptable values are "smooth", "cr1sp",and 
"strong ".This value is ignored if the anti A1 i ased 
property is Tal se. 


autoKern 


Boolean 


If true, uses pair-kerning information in thefont(s) 
to kern the text. If Tal se, pair-kerning information in 
thefont(s) is ignored. Default value is true. 
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Property 


Data type 


Notes 


ori entati on 


string 


Acceptable values are "horizontal left to 
right" (the default), "verti cal right to 
1 eft " hori zontal right to left", and 
"vertical left to right". 


pathAttri butes 


object 


PathAttrs object (see "PathAttrs” on page 40). 


randSeed 


float 


A 32-bit integer. JavaScript integers hold only 31- 
bit numbers, so it is stored as a floating-point 
number. 


textRuns 


object 


TextRuns object (see “TextRuns" on page 44). 


textureOff set 


point 


If the text has a textured brush or fill, specifies the 
offset of the texture’s origin. 


transformMode 


string 


Acceptable values are "paths" and "pixels". 



Texture 

Texture is a subclass of the base class El ement and contains the following read-only property in 
addition to those in El ement (see “Element” on page 29). 



Property (read-only) 


Data type 


Notes 


name 


string 


The name that appears in the Brush or Fill panels. 



ElementMask 

The following table lists the properties of the El ementMask object, which is new in Fireworks 4, 
along with their data types and, where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


autoExpandImages 


Boolean 


If t rue, and the element mask is an image, the 
image is always automatically expanded to fill the 
entire document, with areas “outside” the image 
showing through. If fal se (or if the element mask is 
not an image), areas “outside” the element mask 
are knocked out. 


el ement 


object 


El ement object (see “ElementMask” on page 32). 


enabl ed 


Boolean 


If true, the maskapplies to the element. If fal se, 
the mask remains present but does not visually 
affect the element in anyway. Default value is true. 


1 i nked 


Boolean 


If true, moving the mask moves the element that 
owns it, and vice versa. If false, moving the mask 
does not affect the element that owns it (and 
moving the element does not affect the mask). 
Default value is true. 


mode 


string 


Acceptable values are "mask to image" and 
"mask to path". 


owner 


object 


The element (image, path, text, and so on) that 
owns the mask. 


showAttrs 


Boolean 


If true, and mode is "mask to path", the mask 
element’s fill and stroke (if any) are drawn. If f a 1 s e, 
the mask element’s fill and stroke are ignored. 
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ExportFrameInfo 

The following table lists the properties of the ExportFrameInfoobj ect, along with their data type 
and, where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


del ayTi me 


integer 


For GIF animations, the delay time between frames, in 1/ 
lOOths of a second. For example, if you set del ayTi me 
to 200, two seconds elapse before the next frame in the 
animation appears. Default value is 7. 


f rameHi dden 


Boolean 


If fal se (the default), the frame is exported. If true, the 
frame is hidden and not exported. 


f rameName 


string 


The name of the frame displayed in the Frames panel. 
Default is nul 1 . 


gi fDi sposal Method 


string 


GIF89a frame disposal method. See the GIF89a 
specification for details. Acceptable values are 
"unspeci f i ed" (the default), "none", "background" , 
and "previ ous". 



ExportOptions 

Note: When using this object to set properties, the only required property is export Format, if other properties 
are not specified, their defauit values are used. 

The following table lists the properties of the ExportOpti ons object, along with their data types 
and, where appropriate, acceptable values and notes. 

In addition, use the following information to understand the rules for determining scaling 
in this object. 

If useScal e is true (the default), percentScal e is used to uniformly scale the object on export, 
and applyScal e is ignored. 

If useScal e is fal se and applyScal e is fal se (the default), no scaling is performed on the 
object on export. 

IfuseScale is false and applyScale is true, then xSi ze and ySi ze determine 
scaling as follows: 

• If the value is positive, it specifies the exact size for the axis. 

• If the value is zero, it specifies that the axis varies without limit. 

• If the value is negative, it specifies that the axis varies, but can be no larger than " a b s ( v a 1 u e ) ' 

If one value is positive and one is negative, the positive value is always used. This gives the 
following possibilities: 

• xSize < 0, ySize < 0 - use mi n ( xSi ze , y Si ze ) scaling 

• xSize < 0, ySize = 0 - use xSi ze scaling 

• xSize < 0, ySize > 0 - use y Si ze scaling 

• xSize = 0, ySize < 0 - use y Si ze scaling 

• xSize = 0, ySize = 0 - illegal; use seal e of 1 . 0 

• xSize = 0, ySize > 0 - use y Si ze scaling 

• xSize > 0, ySize < 0 - use xSi ze scaling 
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• xSize > 0, ySize 


= 0 - use 


xSize scaling 




• xSize > 0, ySize 


> 0 - do 


not use; instead, 


useuseScale = true and 


percentScale = 0 


to 100 






Property 




Data type 


Notes 


ant mAutoCrop 




Boolean 


Default value is true. 


ani mAutoDi fference 




Boolean 


Default value is t r u e . 


applyScal e 




Boolean 


Default value is fal se. 


col orMode 




string 


Acceptable values are "indexed" (the default) , 
"24 bi t", and "32 bi t". 


crop 




Boolean 


Default value is false. 


cropBottom 




Integer 


Default value is 0. 


cropLeft 




Integer 


Default value is 0. 


cropRi ght 




Integer 


Default value is 0. 


cropTop 




Integer 


Default value is 0. 


di therMode 




string 


Acceptable values are "none" (the default), 
"diffusion", and "2 by 2". 


di therPercent 




integer 


0 to 100; default value is 100. 


exportFormat 




string 


Acceptable values are "GIF", "JPEG", "PNG", 
"custom", and "GIF ani mati on". There is no 
default; this value must be specified. 


f rameinfo 




array 


Array of ExportFrameInfo ob]ects(see 
“ExportFrameInfo” on page 33); can be nul 1 (the 
default). 


i nterl acedGI F 




Boolean 


Default value is false. 


jpegQual i ty 




integer 


1 to 100; default value is 80. 


jpegSmoothness 




integer 


0 to 8; default value is 0. 


jpegSubsampl i ng 




integer 


0 to 4; default value is 1 . 


1 ocal Adapt! ve 




Boolean 


Default value is true . 


1 ossyGi fAmount 




integer 


0 to 100; default value is 0. 


macFi 1 eCreator 




string 


Default value is " " (an empty string). 


macFi 1 eType 




string 


Default value is " "(an empty string). 


name 




string 


Default value is " " (an empty string). 


numCustomEntri es 




integer 


0 to 256; default value is 0. 


numEntries Requested 




integer 


0 to 256; default value is 1 28. 


numGri dEntri es 




integer 


0 to 256; default value is 6. 


opti mi zed 




Boolean 


Default value is true . 


pal etteEntri es 




array 


Array of color strings (see “Color string" on page 5); 
default value is nul 1 . 
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Property 


Data type 


Notes 


pal etteinfo 


array 


Array of ExportPaletteInfo objects, or nul 1 if all 
entries in the array are default values (see 
“ExportPaletteInfo” on page 35); default value is 
nul 1 . 


pal etteMode 


string 


Acceptable values are "adaptive" (the default), 
"custom", "grid", "monochrome", "Macintosh", 
"Wi ndows ", "exact", and "Web 216" . 


pal etteT ransparencyType 


string 


Acceptable values are "none" (the default), 
" i ndex", "i ndex alpha", and " rgba " . 


percentScal e 


integer 


1 to 100,000; default value is 100. 


progress! veJPEG 


Boolean 


Default value is false. 


savedAnImati onRepeat 


integer 


Default value is 0. 


sort! ng 


string 


Acceptable values are "none" (the default), 
"luminance", and "popul ari ty " . 


transparencyindex 


zero-based 

integer 


-1 to 255; pass - 1 to use the background color’s 
index; default value is - 1 . 


useScal e 


Boolean 


Default value is t r u e . 


webSnapAdapti ve 


Boolean 


Default value is t r u e . 


webSnapTol erance 


integer 


Default value is 14. 


xSi ze 


integer 


-100,000 to 100,000; default value is 0. 

See “ExportOptions” on page 33 for details on 
using xSi ze and ySi ze. 


ySi ze 


integer 


-100,000 to 100,000; default value is 0. 

See “ExportOptions” on page 33 for details on 
using xSi ze and ySi ze. 


ExportPaletteInfo 






The following table lists the properties of the Expo rtPal etteinfo object, along with their data 
types and, where appropriate, acceptable values and notes. 


Property 


Data type 


Notes 


col orLocked 


Boolean 


true if the color is locked in the panel. Default value 
is fal se. 


col orModi ft ed 


Boolean 


true if the color was edited. Default value is fal se. 


col orSel ected 


Boolean 


t r u e if the color is selected in the panel (selection is 
a temporary attribute). Default value is fal se. 


col orT ransparent 


Boolean 


true if the color is exported as transparent. Default 
value is false. 


newCol orVal ue 


string 


If col orModi f i ed is true, specifies the colorthat 
will actually be used. Default value is "#000000". 
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ExportSettings 

The following table lists the properties of the ExportSettings obj ect, along with their data types 
and, where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


baseName 


string 


The name from which all automatically named slice 
names are derived. 


di scardUnspeci ft edSl i ces 


Boolean 


If true, omits undefined slices from export 
operations. 


docHtml Encodi ng 


string 


Determines the encoding standard for the HTML 
file that Fireworks generates during export. 

Use "i so -8859 - 1 " for ASCII or "utf -8" for 
Unicode. 


docXHTMLFormat 


Boolean 


Determines whether Fireworks will output XHTML 
formatted files (true) or HTML formatted files 
(fal se) when the user exports a file. 


exportFi 1 eStyl e 


string 


Acceptable values are: 
“HTMF and Images” 
“Images Only” 
“Dreamweaver FBI” 
"Director HTMF" 

"CSS Fayers" 

"Fayers to Files" 
"Frames to Files" 
"Fotus Domfno" 
"Macromedia Flash SWF" 
"111 ustrator" 
"Photoshop" 


ft 1 eExtensi ons 


string 


Defines the extension to append to the filename. 


generateDemoHtnil 


Boolean 


If true, generates multiple HTML pages for button 
export. 


htnil Desti nati on 


string 


Acceptable values are "same", "custom", and 
"cl 1 pboard" . 


setByUser 


Boolean 


If t rue, the user specifies the export settings. If 
fal se, thefirst time the file is exported. Fireworks 
chooses settings based on the data. 


shi mGenerati on 


string 


Acceptable values are "none" (no shims), 
"transparent" (one-pixel transparentshims), and 
"nested tables" (no shims, but nested tables). 


si i ceAl ongGui des 


Boolean 


If t rue, use guides for slicing (and 
si 1 cellsi ngUrl s should be fal se). 
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Property 



Data type Notes 



si 1 ceAutoNami ngl through 
si 1 ceAutoNami ng6 



si 1 ceFrameNanii ngl and 
si 1 ceFrameNanii ng2 



si 1 ceUsi ngUrl s 



string 



string 



Booiean 



Used to generate a name by concatenating six 
strings, if you need fewer than six strings, fiii in the 
remaining strings with "none". 

Acceptabie vaiues are: 

"none" - generates nothing. 

" row_col " - generates a unique row and coiumn 
index; 0_0 is first, 0_1 is second, and so on. 
"ALPFiA" — generates a unique uppercase ietter: A 
is first, B is second, and so on. 

"alpha" - generates a unique iowercase ietter: a 
is first, b is second, and so on. 

"numeri cl " - generates a unique number: 1 is 
first, 2 is second, and so on. 



"numeri cOl" — generates a unique two-digit 
number: 01 is first, 02 is second, and so on. 
"doc . name" - name of the fiie being exported, 
without a path or extension, such as " image", 
"si i ce" - the string "si i ce". 



"underscore" - the underscore character (J 
"peri od" - the period character (.) 

"space" - the space character ( ) 

"hyphen " - the hyphen character (-) 

For example, to generate names of 
"i mage_sl i ceOl ", " i mage_sl i ce02", and so on 
from a document named "image", set the foiiowing 
properties: 

si i ceAutoNami ngl : "doc. name" 
si i ceAutoNami ng2: "underscore" 
si i ceAutoNami ng3 : "slice" 
si i ceAutoNami ng4 : "numeri cOl " 
si i ceAutoNami ng5 : "none" 
si i ceAutoNami ng6 : "none" 



Used to generate a name by concatenating two 
strings; the resuiting string is concatenated to the 
name that is specified by si i ceAutoNami ng. if you 
need fewer than two strings, fiii in the remaining 
string with "none". 

Acceptabie vaiues are: 

"none" - generates nothing. 

"frameNumber" - generates frame number 
preceded by f, for example, f 2. 

"number" - generates frame number, for 
example, 2. 

"state" - generates frame state, for example, 
"over", "down", or "overdown", 
"abbreviation" - generates abbreviated state, 
forexampie, "o", "d",or "od". 

"underscore" - the underscore character (J 
"peri od" - the period character (.) 

"space" - the space character ( ) 

"hyphen " - the hyphen character (-) 



if t rue, use slice objects for slicing (and 
si i ceAl ongGui des should be fal se). 



tempi ateName string HTMLstyie to be used during export. Acceptable 

vaiues are "Dreamweaver", "Generic", 
"Frontpage", "GoLi ve", or a user-created HTML 
style. 



The Fireworks Object Model 37 




Fill 



The following table lists the properties of the F i 1 
appropriate, acceptable values and notes. 


1 object, along with their data types and, where 


Property 


Data type 


Notes 


category 


string 


Specifies where this Fill appears in the Fill panel. 


di therCol ors 


array 


Array of two color strings (see “Color string” on 
page 5). 


edgeType 


string 


Acceptable values are "hard" and 
"anti al i ased". 


feather 


integer 


0 to 1000, which represents the feathering value in 
pixels (0 means no feathering). 


gradi ent 


object 


Gradi ent object (see “Gradient” on page 39). 


name 


string 


The name that appears in the Fill panel. 


pattern 


object 


Pattern object (see “Pattern” on page 41). 


shape 


string 


Acceptable values are "solid", "linear", 

" radi al ", "coni cal ", "satin", "pinch", 
"fol ds ", "el 1 i pti cal ", "rectangular", 
"bars ", " ri ppl e", "waves", "pattern ", and 
"web dither". 


stampi ngMode 


string 


Acceptable values are "blend" and 
"blend opaque". 


textureBl end 


fioat 


0 to 100 


webDitherTransparent 


Boolean 


If true (and shape is "web di ther"), then the 
second color in the di therCol ors array is ignored 
and transparent is used instead. 



Frame 



The following table lists the properties of the Frame object, along with their data types and, where 
appropriate, acceptable values and notes. Read-only properties are marked with a bullet (•). 



Property 


Data type 


Notes 


del ay 


integer 


Hundredths of a second. 


di sposal 


string 


Acceptable values are "unspeci f i ed", "none", 
"background", and "previous". 


layers • 


array 


Array of FrameNLayerIntersecti on objects in 
the document (see “FrameNLayerIntersection”). 


visible 


Boolean 


If f al se, this frame is hidden. Default value is true. 
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FrameNLayerIntersection 

The following table lists the properties of the FrameNLayerIntersection object, along with 
their data types and, where appropriate, acceptable values and notes. Read-only properties are 
marked with a bullet (•). 



Property 


Data type 


Notes 


elements • 


array 


Array of El ement objects (see “Element” on page 
29). 


1 ocked 


Boolean 


If true, this FrameNLayerIntersection is locked. 
Default value is false. 


visible 


Boolean 


If fal se. this FrameNLayerIntersection is hidden. 
Default value is true. 


Gradient 






The following table lists the properties of the Gradi 
where appropriate, acceptable values and notes. 


ent object, along with their data types and. 


Property 


Data type 


Notes 


name 


String 


The name that appears in the Fill panel. 


nodes 


array 


Array of Gradi entNode objects (see 
“GradientNode” on page 39). 


opaci tyNodes 


array 


Array of Gradi entNode objects (see 
“GradientNode” on page 39), that identify the 
opacity ramp that is associated with a gradient. 


GradientNode 






The following table lists the properties of the Gradi entNode object, along with their data types 
and, where appropriate, acceptable values and notes. 


Property 


Data type 


Notes 


col or 


string 


A color string that specifies the color at this position 
in the gradient (see “Color string” on page 5). 


i sOpaci tyNode 


Boolean 


If true, this node is part of the gradient’s opacity 
ramp. 


posi ti on 


float 


0.0 to 1.0 


Guides 






The following table lists the properties of the Guides object, along with their data types and, 
where appropriate, acceptable values and notes. 


Property 


Data type 


Notes 



color string Acolorstring that specifies the color that is used for 

fhe guides (see “Color string” on page 5). 

hGuides array Array of floating-point numbers that specify 

horizontal guide locations. 
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Property 


Data type 


Notes 


1 ocked 


Boolean 


If true, the user cannot select or move the guides. 
Default value is fa 1 s e. 


vGui des 


array 


Array of floating-point numbersthat specify vertical 
guide locations. 


Layer 






The following table lists the properties of the Layer 


object, along with their data types and, where 


appropriate, acceptable values and notes. Read-only properties are marked with a bullet (•). 


Property 


Data type 


Notes 


disci osure 


Boolean 


If true, the Layers list displays all the objects in the 
layer. If f a 1 s e, only the name of the layer appears. 


frames • 


array 


An array ofFrameNLayerIntersection 
objects (see “FrameNLayerIntersection” on page 
39). 


layerType • 


string 


Acceptable values are "normal " and "web". 


name 


string 


Might be n u 1 1 (removes any existing name). 


sharing 


string 


Acceptable values are "shared" and 
"not shared". 


PathAttrs 






The following table lists the properties of the PathAttrs object, along with their data types and. 


where appropriate. 


acceptable values and notes. 




Property 


Data type 


Notes 


brush 


object 


Brush object (see “Brush" on page 21). 


brushCol or 


string 


A color string that specifies the color that is used for 
rendering the Brush object, if any (see “Color 
string" on page 5). 


brushPl acement 


string 


Acceptable values are "fnsfde", "center", and 
"outside". 


brushTexture 


object 


Texture object (see “Texture” on page 32). 


fill 


object 


Fill object (see “Fill” on page 38). 


f i 1 1 C 0 1 0 r 


string 


A color string that specifies the color that is used for 
rendering the F i 1 1 object, if any (see “Color string” 
on page 5). 


f i 1 1 Handl el 


point 




f i 1 1 Handl e2 


point 


The three f i 1 1 Handl e properties are used by 
Gradient and Pattern fills to set the angle and size of 


f i 1 1 Handl e3 


point 


the gradient/pattern. 


fi 1 1 OnTop 


Boolean 


If true, the fill is drawn on top of the brush; if f al se 
(the default), the fill is drawn beneath the brush. 


f i 1 1 Texture 


object 


Texture object (see “Texture” on page 32). 
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Pattern 



The following table lists the properties of the Pattern object, along with their data types and, 
where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


name 


string 


The name that appears in the Fill panel. 



RectanglePrimitive 

The following table lists the properties and methods of the RectanglePrimitive object, along 
with their data types and, where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


roundness 


float 


Afloat value between 0 and 1 that specifies the 
“roundness” to use for the corners (0 is no 
roundness, 1 is 100-percent roundness). 


0 r 1 g 1 n a 1 S i d e s 


rectangle 


A rectangle that specifies the original sides of the 
primitive (see “Rectangle” on page 6). Because 
rectangle primitives remember transformations, the 
user might see something different from the 
original sides. 


transform 


matrix 


A matrix that indicates all the transformations that 
were applied to the primitive (see “Matrix” on page 
6). 


pathAttri butes 


object 


APathAttrs object that indicates the path 
attributes of the primitive (see “PathAttrs” on page 
40). 



SingleTextRun 

The following table lists the properties of the Si ngl eTextRun object, along with their data types 
and, where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


changedAttrs 


object 


TextAttrs object (see “TextAttrs” on page 43). 


characters 


string 


The text that is contained in this run. 



Style 

The following table lists the properties of the Sty 1 e object, along with their data types and, where 
appropriate, acceptable values and notes. All Style properties are read-only. 



Property (read-only) 


Data type 


Notes 


ef fectLi St 


object 


Effect Li st object (see “EffectList” on page 29). 


name 


string 


The name displayed in the Style panel. 


pathAttri butes 


object 


PathAttrs object (see “PathAttrs” on page 40). 


tdfagText 


string 


A string that contains all the attributes of a table cell 
except col span and rowspan. Should be in a 
format similar to the following: 

"bgcol or="ff0000" val i gn=" top" “ 
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Property (read-only) 


Data type 


Notes 


textBol d 


Boolean 


Whether to make the affected text bold; used only if 
use_textStyl es is true. 


textFont 


string 


The font to apply to text; used only if 
use_textFont is true. 


textital 1 c 


Boolean 


Whether to make the affected text italic; used only if 
use_textStyl es is true. 


textSi ze 


string 


String of the form "#pt ", where# is a numeric 
value. 


textUnderl i ne 


Boolean 


Whether to underline the affected text; used only if 
use_textStyl es is true. 


use_brush 


Boolean 


If true, applies the brush property from the 
path At tributes object when applying the style. If 
false, ignores the brush property. Default value is 
fal se. 


use_brushCol or 


Boolean 


If true, applies the brushCol or property from the 
path At tributes object when applying the style. If 
fal se, ignores the brushCol or property. Default 
value is fal se. 


use_eff ectLi st 


Boolean 


If true, applies the effects property from the 
effect Li st object when applying the style. If 
false, ignores the effects property. Default value 
is fal se. 


use_f i 1 1 


Boolean 


If true, applies the fi 1 1 property from the 
path At tributes object when applying the style. If 
false, ignores the fi 1 1 property. Default value is 
fal se. 


use_f i 1 1 Col or 


Boolean 


If true, applies the fi 1 1 Col or property from the 
path At tributes object when applying the style. If 
fal se, ignores the fi 1 1 Col or property. Default 
value is fal se. 


use_textFont 


Boolean 


If true, applies the textFont property from the 
path At tributes object when applying the style. If 
fal se, ignores the textFont property. Default 
value is fal se. 


use_textSi ze 


Boolean 


If true, applies the text Si ze property from the 
path At tributes object when applying the style. If 
fal se, ignores the textSi ze property. Default 
value is fal se. 


use_textStyl es 


Boolean 


If true, applies the textStyl es property from the 
path At tributes object when applying the style. If 
fal se, ignores the textStyl es property. Default 
value is fal se. 
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TextAttrs 



The following table lists the properties of the T extAttrs object, along with their data types and, 
where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


al i gnment 


string 


Acceptable values are "left", "center", 
"right", " justi fy", and "stretch". 


basel i neShi ft 


integer 


The number of pixels above (positive numbers) or 
below (negative numbers) the baseline by which the 
characters are shifted. 


bol d 


Boolean 


true for bold text, fal se for normal text. 


face 


string 


The name of the font, such as Arial. 


f i 1 1 C 0 1 0 r 


string 


A color string that specifies the color of the text (see 
“Color string” on page 5). 


hori zontal Seal e 


fioat 


The relative width of the characters. 
1.0 - normal width 
< 1 - thinner than normal 
>1 - wider than normal 


italic 


Boolean 


true for italic text, fal se for normal text. 


kerni ng 


float 


Also known as pair kerning, it is the percentage of 
an em sguare by which to separate two characters, 
in addition to the amount the font specifies. Applies 
to only one pair or characters. To specify kerning for 
a range of text, use the rangeKerni ng property. 

0 - normal kerning 

< 0 - move the two characters closer together 
> 0 - move the two characters farther apart 


leading 


float 


The spacing between two lines of text, measured 
from baseline to baseline. Larger numbers place 
more space between lines of text. Smaller numbers 
move the lines closer together. The exact effect of 
this property number depends on the value of the 
1 eadi ngMode property. 


1 eadi ngMode 


string 


The only acceptable value is "percentage", which 
specifies that the leading property is a percentage 
of the text’s point size. A 1 eadi ng property of 1.0 
would mean 100 percent or single-spaced, 2.0 
would mean 200 percent or double-spaced, and so 
on. 


rangeKerni ng 


float 


The same as kerning, but applies to a range of text, 
not only two characters. 


si ze 


string 


String of the form "#pt ", where# is a numeric 
value. 


underline 


Boolean 


true for underlined text, fal se for normal text. 
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TextRuns 



The following table lists the properties of the TextRuns object, along with their data types and, 
where appropriate, acceptable values and notes. 



Property 


Data type 


Notes 


i ni ti al Attrs 


object 


TextAttrs object (see “TextAttrs” on page 43). 


textRuns 


array 


Array of Si ngl eTextRun objects on this TextRuns 
object (see “SingleTextRun” on page 41). 



HTML export objects 

Fireworks provides several object types that support the output of HTML and sliced images from 
Fireworks. These objects let you write JavaScript scripts that create templates to output the type 
of HTML that suits your specific requirement (generic HTML, Dreamweaver-compatible 
HTML, and so on). For each HTML template, use a Slices. htt file that generates the HTML for 
that particular template. For more information, refer to the Slices. htt and Metafile. htt files that 
are installed with Fireworks. 

Note: For information on how to format nonstandard data types, such as rectangie or point, see “Formatting 
nonstandard data types” on page 5. 

Behaviorinfo 

The Behavi orinfo object describes a behavior that is assigned to an element. There are seven 
behaviors: Status Message, Swap Image, Button Down, Swap Image Restore, Button 
Highlight, Button Restore, and Popup Menu (new in Fireworks 4). The following table lists 
the properties of the Behaviorinfo object, along with their data types and, where appropriate, 
acceptable values and notes. All Behaviorinfo properties are read-only. 

Property (read-only) Data type Notes 

action integer Specifiesthetypeof behavior: 1 is Status Message, 

2 is Swap image, 4 is Button Down, 5 is Swap 
Image Restore, 6 is Button Highlight, 7 is Button 
Restore, and 9 is Popup Menu. In the standard 
(default) templates, the following values are 
defined: 

var kActi onStatusMessage = 1: 
var kActionSwapImage = 2: 
var kActi onButtonDown = 4; 
var kActionSwapImageRestore = 5; 
var kActi onButtonHi ghl 1 ght = 6; 
var kActi onButtonRestore = 7: 
var kActionPopupMenu = 9: 

down Hi ghl i ght Boolean For button highlight behaviors, true if there is a 

down highlight image. 

event integer Specifies the type of event: 0 is Mouse Over, 1 is 

On Click, 2 is Mouse Out, and 3 is On Load. In the 
standard (default) templates, the following values 
are defined: 

var kEventMouseOver = 0: 
var kEventOnCl i ck = 1: 
var kEventMouseOut = 2: 
var kEvent0nEoad=3 : 
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Property (read-only) 


Data type 


Notes 


hasHref 


Boolean 


For swap image behaviors, true if the swap image 
swaps in an external file. The value of hasHref is 
always the opposite of hasTargetFrame; you 
cannot swap from two sources. 


hasStatusText 


Boolean 


For status message behaviors, true if the status 
text is not empty. 


hasTargetFrame 


Boolean 


For swap image behaviors, true if the swap image 
swaps in another frame in the Fireworks file. The 
value of hasTargetFrame is always the opposite of 
hasHref; you cannot swap from two sources. 


horzOff set 


integer 


If act f on is set to 9 (Popup Menu), horzOffset 
specifies the horizontal pixel offset for the menu. 


href 


string 


The argument must be which is expressed as a file;/ 
/URL. For swap image behaviors, the file URL for 
an external swap image file. 


prel oad 


Boolean 


For swap image behaviors, true if the image is to 
be preloaded. 


restoreOnMouseout 


Boolean 


If true, the original image for a swap image 
behavior is restored on mouse out. 


statusText 


string 


For status message behaviors, the status message 
text. 


targetCol umnNuni 


zero-based 

integer 


For swap image behaviors, the column in the slices 
table that is swapped. 


targetFrameNum 


zero-based 

integer 


For swap image behaviors, if hasTargetFrame is 
true, this frame number is swapped. 


targetRowNum 


zero-based 

integer 


For swap image behaviors, the row in the slices 
table that is swapped. 


vertOff set 


integer 


If actf on is set to 9 (Popup Menu), 
vertOffset specifies the vertical pixel offset for 
the menu. 



BehaviorsList 

The Behavi orsLi st object is an array of Behavi orinfo objects that describe the behaviors in an 
image map (see “Behaviorinfo” on page 44). The Behavi orsLi st object does not occur by itself 
That is, all occurrences of Behavi ors Li st objects are members of other objects. In the following 
example, behavi ors is an object of type Behavi ors Li st, and curBehavi or is an object of 
type Behavi orinfo. 

var curBehavior = si i ces [i ] [j ]. behavi ors [k] ; 

The Behavi orsLi st object has only one property, which is read-only and is shown in the 



following table. 


Property (read-only) 


Data type 


Notes 


numberOf Behavi ors 


integer 


The number of Behavi orinfo objects in the 
Behavi ors Li st array (0 or more) (see 
“Behaviorinfo” on page 44). 
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exportDoc 

The following table lists the properties of the exportDoc object, along with their data types and, 
where appropriate, acceptable values and notes. All exportDoc properties are read-only. 

Note: This object type does not start with a capitai letter. 



Property (read-only) 


Data type 


Notes 


al tText 


string 


The alternate text description for the Fireworks 
document. 


backgroundCol or 


string 


The hex color of the document canvas, without the 
# character; for example, "FFOOOO" for red 
background. 


backgroundlsTransparent 


Boolean 


true if the Fireworks canvas color is transparent or 
if the export settings specify a transparent GIF 
format; false othen/vise. 


backgroundLi nk 


string 


The background URL, which is expressed as a 
file://URL. 


docID 


integer 


A number that is assigned to a document to help 
identify HTML generated from it. The doc ID does 
not change when you change the name of a file. 
However, if you use File > Save As, you can get 
multiple files with the same doc ID. 


docSaveFol der 


string 


docSaveFol der contains the path of the directory 
into which the document was last saved. If the 
document has not yet been saved, this is an empty 
string. 


docSaveName 


string 


The filename used when the document was saved, 
without path information, such as " n a v . g f f " . 


emptyCel 1 Col or 


string 


A color string that specifies the color of empty table 
cells (see “Color string” on page 5). 


emptyCel 1 Contents 


integer 


Specifies what to put into empty cells. Acceptable 
values are 1 (nothing), 2 (spacer image), and 3 
(nonbreaking space). 


emptyCel lUsesCanvasCol or 


Boolean 


If true (the default), empty cells are set to the 
backgroundCol or property. If f al se, they are set 
to the emptyCel 1 Col or property. 


f i 1 ename 


string 


URL for the exported image, relative to the HTML 
output; for example, " images /But ton . gf f". In the 
Slices.htt file, it is the base image name plus the 
base extension. Unless there is only one slice, the 
Slices.htt file produces filenames such as 
"Button_r2_c2 .gif". 


generateHeader 


Boolean 


true if an HTML file is generated; false if the 
output goes to the Clipboard. 


hasAl tText 


Boolean 


true if the Fireworks document has an alternate 
text description. 


hasBackgroundti nk 


Boolean 


true if the Fireworks document has a background 
URL. 


height 


integer 


Height of the image that is being exported, in pixels. 
In the Slices.htt file, it is the total height of the 
output images. 
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Property (read-only) 


Data type 


Notes 


htnil Encodi ng 


string 


Determines the encoding standard for the HTML 
file that Fireworks generates during export. 

Use "i so-8859-1" for ASCII or "utf-8" for 
Unicode. 


htnil OutputPath 


string 


File that the HTML is being written to, including 
filename, which is expressed as a file://URL; for 
example, "file:///C|/top/nav/navbar.htm". 


i magename 


string 


Name of the image that is being exported, without 
extension; for example, "Button ". 


i ncl udeHTMLComments 


Boolean 


The value of the Include HTML Comments 
preference, which the export script interprets as 
appropriate. For example, if this value is false, the 
Dreamweaver export script removes all 
nonessential comments. 


numFrames 


integer 


Number of frames that are being exported from the 
Fireworks document. This value is not zero-based; 
the value isl or more. 


pathBase 


string 


Path of the image that is being exported; for 
example, "images/Button". 


pathSuf f i X 


string 


Filename extension of the image that is being 
exported, including a period; for example, " . g f f " . 


started umn 


integer 


Used only in the Metafile.htt file for generating 
HTML for one slice. Specifies the column of the 
slice. 


startRow 


integer 


Used only in the Metafile.htt file for generating 
HTML for one slice. Specifies the row of the slice. 


styl e 


string 


The HTML style that is used to export the data, 
such as "Dreamweaver", "Generi c", or 
"Frontpage". 


tabl eAl i gnment 


string 


A string that contains the alignment of the table. If 
the table is left-aligned, the string is simply a space 
(this is used for writing the HTML table). If the table 
is center-aligned, the string is "al i gn= "center" ". 
If the table is right-aligned, the string is 
"alt gn=" rf ght " ". 


width 


integer 


Width of the image being exported, in pixels. In the 
Slices.htt file, it is the total width of the output 
images. 


xhtml Format 


Boolean 


Determines whether Fireworks will output XHTML 
formatted files (true) or HTML formatted files 
(false) when the user exports a file. 
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ImageMap 

The following table lists the properties and methods of the ImageMap object, along with their data 
types and, where appropriate, acceptable values and notes. All ImageMap properties are read-only. 



Property (read-only) or Method 


Data type 


Notes 


al tText 


string 


The aiternate text description for this siice, if any. 


behavi ors 


object 


Behavi ors List object that contains the 
behaviors for this siice (see “BehaviorsList” on 
page 45). 


hasAl tText 


Boolean 


true if the siice has an aiternate text description. 


hasHref 


Boolean 


true if the siice has a URL 


hasTargetText 


Boolean 


true if the target text is not empty. 


href 


string 


The URL iinkforthis siice. The argument must be 
which is expressed as a fiie://URL. 


nuniCoords 


integer 


Number of coordinates in the area. A circie aiways 
has 1 (the center), a rectangie has 2 (top ieft and 
bottom right), and a poiygon has 1 or more. 


radi us 


integer 


Radius of the area, if shape is "circle". 


shape 


string 


Acceptabie vaiues are "circle", "poly", 
and "rect". 


targetText 


string 


T arget text for this image, if any. 


xCoord( i ndex) 


zero-based 

integer 


Returns the x coordinate for the specified point, in 
pixeis. For exampie, the foiiowing commands 
return the coordinates for the first point: 
var X = imagemap. xCoord(O) : 
var y = imagemap. yCoord(O) : 
it is possibie to have negative vaiues if the image 
map area is drawn so that it crosses the ieft or top 
sides of the image (or siiced image). 


yCoord( i ndex) 


zero-based 

integer 


Returns thejy coordinate for the specified point, in 
pixeis. See xCoord( ). 



ImagemapList 

The ImagemapLi st is an array of ImageMap objects that describe the areas in an image map (see 
“ImageMap” on page 48). To access i mageMap objects, use the ImagemapLi st array, as 
shown below: 

var curlmagemap = ImagemapLi st[i ] ; 

The ImagemapLi st object has only one property, which is read-only and shown in the 
following table. 



Property (read-only) 


Data type 


Notes 


numberOf URLs 


integer 


The number of image map areas in the image map 
iist (0 or more). 
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Sliceinfo 



The following table lists the properties and methods of the SI i ce I nf o object, along with their 
data types and, where appropriate, acceptable values and notes. All SI i ceinfo properties 
are read-only. 



Property (read-only) or Method 


Data type 


Notes 


al tText 


string 


The alternate text description for this slice. 


behavi ors 


object 


Behavi ors Li St object that contains the 
behaviors for this slice (see “BehaviorsList” on 
page 45). 


cel 1 Flei ght 


integer 


F-leight of this table row in pixels. 


cel 1 Wi dth 


integer 


Width of this table column in pixels. 


downindex 


zero-based 

integer 


The index for this slice as a button if it is a multiple 
file button export down. 


getFrameFi 1 eName (frameindex) 


zero-based 

integer 


Returns a string that is the filename for the slice on 
the specified frame, without directory or extension 



information. For exampie, when exporting a file 
base named Button, 

Slices[0][0].getFrameFileName(0) returns 
"Button_rl_cl Generally all slices that have 
images have a frame filename. For frames 1 and 
higher, only slices that are rollovers or that are 
targeted by a swap image have names. 



hasAl tText 


Boolean 


t rue if the slice has an alternate text description. 


hasHref 


Boolean 


true if the slice has a URL. 


hasHtml Text 


Boolean 


true if the cell is a text-only slice. 


has Image 


Boolean 


t rue if this cell has an image. For text-only slices, 
this is fal se. 


hasimagemap 


Boolean 


true if there are image map hotspots in this image 
slice. 


hasTargetText 


Boolean 


true if the target text is not empty. 


height 


integer 


F-leight of the image in pixels, including row spans. 


href 


string 


The URL link for this slice. The argument must be 
which is expressed as a file://URL. 


html Text 


string 


Text for a text-only slice. 


i magemap 


object 


ImagemapLl st object containing the image map 
information for this slice (see “ImagemapList” on 
page 48). 


i mageSuff i x 


string 


Extension for the image in this cell, including a 
period (.): for example, ".gif". 


1 sUndef i tied 


Boolean 


true if the slice does not have a slice object drawn 
over it. If you draw two slices that don’t cover your 
document, Fireworks automatically generates 
slices to cover the rest of the document. These 
slices are undefined. 


1 eft 


integer 


Left side of the cell in pixels. The left starts at 0. 
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Property (read-only) or Method 


Data type 


Notes 


nestedfabl eSl i ces 


object 


Slices object that describes a nested table that 
occupies the current table cell (see “Slices” on 
page 50). null if the cell does not contain a nested 
table. 


setFrameFi 1 eName (franieindex) 


zero-based 

integer 


Sets the filename for the slice on the specified 
frame, without directory or extension information. 
You can stop an image from exporting by setting its 
name to " " (an empty string). 


ski pCel 1 


Boolean 


t rue if this cell in the table is covered by a previous 
row span or column span. 


targetfext 


string 


Target text for this image, if any. 


top 


integer 


Top of the cell in pixels. The top starts at 0. 


wi dth 


integer 


Width of the image in pixels, including column 
spans. 



Slices 

SI i ces is an object that has some properties and is also a two-dimensional array of SI i ceinfo 
objects (see “Sliceinfo” on page 49). For example, SI i ceslO] [0] is the SI i ceinfo for the first 
cell at row 0, column 0. The first array is rows, the second is columns. 

The following example shows a common way to access the table: 

van curRow: 
van curCol ; 

for (curRow = 0; curRowSsl i ces . numRows ; curRow++) { 

for (curCol=0; curCoKsl i ces . numCol umns ; curCol++) { 

var curSlice = si i ces [curRow] [curCol ] ; // curSlice is the slice info 
for the cell at this row & 
col umn . 

// do whatever processing with curSlice. 




The following table lists the properties of the Slices object, along with their data types and, 
where appropriate, acceptable values and notes. All Slices properties are read-only. 



Property (read-only) 


Data type 


Notes 


demoindex 


zero-based 

integer 


Index for each file generated for multiple file button 
export. 


doDemoHTML 


Boolean 


true for multiple file button rollover export. 


doShi mEdges 


Boolean 


true if table shims are set to Transparent Image in 
Document properties. 


doSki pUndef f ned 


Boolean 


true if Export Undefined Slices is not checked in 
Document Properties. 


i magesDf rPath 


string 


Relative URL to the images folder. For example , 

" 1 mages / ", or " . . / si te_i mages ", or " " (an 
empty string) if the images and the EHTMLare in the 
same directory. 


nuniCol umns 


integer 


Number of columns that are present in the F-ITML 
table. Does not include shim column. 
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Property (read-only) 


Data type 


Notes 


numRows 


integer 


Number of rows that are present in the HTML table. 
Does not include shim row. 


shimPath 


string 


Relative URL to the shim GIF file; for example, 
"fmages/shfni.gi f". 



Working with seiected objects 

When an object is seiected, you can return (get) or set the value of that object’s properties. In 
Fireworks, an object is classified as one of the following element types: 

• Hotspot 

• SliceHotspot (basically, a slice) 

• Path 

• Group 

• Instance 

• Text 

• RectanglePrimitive 

• pathAttributes 

• Image 

To test to see if a text block is selected, type the following code: 
f i rstSel ecti on = fw. sel ecti on[0] ; 

if ( f i rstSel ecti on == "[object Text]"){ 
alert("I am a text block"): 

I 

You can use the information in the following sections to return or set property values. 

Note: The return value fora property may be nul 1 . 

Working with properties for any seiected object 

You can return and set the properties in the following list of any type of selected object: 

• top 

• left 

• width 

• height 

• visible 

• opacity 

• blendMode 

• name 

• mask 
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To return the name of the selected object, type the following code: 
objectName=fw . sel ecti on[0] . name ; 

The following properties contain other properties that you can return or set: 

elementMask 

• element 

• linked 

• enabled 

• mode 

• showAttrs 

• autoExpandImages 

effectList 

• name 

• effects 

To return the name of the first effect that is applied to the selected object, type the following code: 
effectName=fw . select i on[0]. effectList. effect s[0]. name; 

Working with specific properties for elements 

Some elements have specific properties that can be returned and set in addition to the list of 
properties in “Working with properties for any selected object” on page 51. 

Hotspot 

• shape 

• urlText 

• altfext 

• targetfext 

• contour 

• behaviors (returns an array of behaviors) 

• color 

To return the a 1 1 tag that has been applied to the currently selected hotspot, type the 
following code: 

altfag = fw . sel ecti on[0] . al tfext ; 
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SliceHotspot 

SliceHotspot is a subclass of Hotspot. A slice has all the Hotspot’s properties, plus the 
following properties: 

• baseName 

• htmlText 

• tdTagText 

• si i ceKi nd (" i mage" or "empty") 

• exportOpti ons 

• s 1 i c e I D (read-only) 

To return the name of the currently selected slice, type the following code: 
sliceName = fw. sel ecti on[0] . baseName : 

Path 

• pathAttri butes 

Note: For the complete list of path attributes properties, see “pathAttributes" on page 54. 

• randSeed 

• textureOff set 

• contours 

To return the value of the fill color for the currently selected path, type the following code: 
fillColor = fw. sel ecti on[0] . pathAttri butes . fi 1 1 Col or 

Group 

• elements 

• groupType 

To return the number of objects in a selected group, type the following code: 
numOfObjectsinGroup = fw. sel ecti on[0] . el ements . 1 ength : 

Instance 

• symbol I D 

• transformMode 

• instancefype 

• urlText 

• altfext 

• targetfext 

To return the i nstancefype for the currently selected instance, type the following code: 
instance = fw. sel ection[0] . instancefype; 
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Text 

• antiAliased 

• anti A1 i asMode 

• autoKern 

• orientation 

• pathAttri butes 

Note: For the complete list of path attributes properties, see “pathAttributes” on page 54. 

• randSeed 

• textRuns 

• textureOff set 

• transforniMode 

To return the anti A1 i asMode setting for the currently selected text block, type the 
following code: 

anti A1 i asedSetti ng = fw. sel ecti on[0] . anti A1 i asMode ; 

RectanglePrimitive 

• Roundness 

• pathAttributes 

Note: For the complete list of path attributes properties, see “pathAttributes” on page 54. 

• ori gi nal Si des 

• transform 

To return the roundness setting for the currently selected rectangle, type the following code: 
roundness = fw. sel ecti on[0] . roundness ; 

pathAttributes 

Several objects have the pathAttri butes property. The following list is the valid set of 
pathAttri butes subproperties that can be returned or set: 

• brushColor 

• fill Col or 

• brush 

• fill 

• brushfexture 

• fillTexture 

• fill Handl el 

• fill Handl e2 
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• fillHandleS 

• brushPl acement 

• fillOnTop 

To return the name of brush on the current path, type the following code: 
brush = fw . sel ecti on[0] . pathAttri butes . brush . name ; 
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CHAPTER 3 

Fireworks JavaScript API 



To make it possible to create useful Fireworks extensions and customized Fireworks menus, 
Fireworks supports the JavaScript functions that are listed in this chapter. Almost any task that 
the user can accomplish in Fireworks with the menus, tools, or floating panels can now be done 
using JavaScript. 

Using Fireworks API functions 

Three categories of API functions are described in this chapter: Document functions, Flistory 
panel functions, and Fireworks functions. The following rules apply to all functions. 

Zero- based indexes 

Some functions take an index argument which is a zero-based-one-dimensional array. That 
means a value of 0 represents the first item in the array, 1 represents the second item, and so on. 
For example, the following command deletes the second layer of the active Fireworks document: 

f w. ge t Document DOM ( ) .del eteLayer2 : 

Functions that take a frameindex argument can be passed -1 to indicate the current 
frame. Similarly, functions that take a / ayerindex argument may be passed -1 to indicate 
the current layer. 

Passing null values 

In general, passing a n u 1 1 value to a function causes an exception to be thrown. A few functions 
do allow null as an argument; such cases are noted in the function descriptions. 

Operating on a selection 

Many API functions in this chapter refer to a “selection” or to “selected items.” These terms refer 
to Fireworks elements, such as text boxes or images, that are currently selected. In most cases, the 
functions work even if only one item is selected. If a function requires more than one selected 
item, this is noted in the description of the function. 

Palette or panel 

Several API functions reference the History panel (see “History panel functions” on page 197). 
Throughout the Fireworks documentation and online help, the term “palette” is reserved for 
discussions of a color palette, and the term “panel” is used to refer to the floating windows that are 
available within Fireworks. Therefore, when the function name contains “palette,” the 
descriptions refer to a “panel.” 



57 




Document functions 

As discussed in “Accessing a Fireworks document” on page 7, you get and set document properties 
by calling functions as methods of the document’s Document Object Model (DOM). Methods 
that operate on a document’s DOM are listed in this section as dom. f uncti onName( ). However, 
you cannot simply type dom. f uncti onNamei ). In place of dom, you must type 
fw.getDocumentDOM( ) or fw.documents[documentIndex]. For example: 

• How a function looks in this manual: dom . addNewHotspot ( ) 

• How you must type it: 

fw.getDocumentDOM( ) .addNewHotspot( ) ; // operates on active document 
or 

fw.documentsIdocumentJndex] .addNewHotspoti ) ; // operates on specified 
document 

dom.addBehaviorO 

Availability 

Fireworks 3 

Description 

Adds a specified behavior to the selected hotspots and slices. 

Arguments 

action, event, eventindex 

• act 7 017 is a string that specifies the behavior to be added, such as "MM_swapImageRestore( ) ". 
For a list of all the behaviors that can be added, see “Using the addBehavior() function” on 
page 20 1 . 

• event specifies the event that triggers the behavior. Acceptable values are ''onMouseOver'', 
''onMouseOuf, "onLoad", and "onCl i ck". 

• eventindex is a zero-based integer that specifies the location where the behavior should be 
added. To specify the end location, pass - 1 here. 

Returns 

Nothing. 

Example 

The following command adds a simple rollover behavior at the end of the selected slice 
or hotspot. 

fw . getDocumentDOM( ).addBehavior( "MM_si mpl eRol 1 over ( ) " , "onMouseOver" , - 1 ) ; 

Related functions 

dom. removeBehavi or( ) 
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dom.addElementMaskO 

Availability 

Fireworks 4 

Description 

Adds a new empty mask to the selected element. If the selection already has an element mask, it 
is replaced with the new one. Only one element can be selected when calling this function. If 
selecting more than one element (or none) at the time this function is called, Fireworks throws 
an exception. 

Arguments 

mode, I bEnterMaskEdi tModel 

• Acceptable values for mode are "reveal all”, "hide all”, "reveal selection", and 
"hide sel ecti on " . If the user is not in bitmap mode, or if there is no pixel 

selection, " reveal selection" and "hide selection" operate the same as " reveal all" 
and "hide all", respectively. 

• If (bEnterMaskEdi tModej (optional) is true. Fireworks enters mask-edit mode on the newly 
added mask; if omitted, it defaults to false. 

Returns 

Nothing. 

dom.addFramesO 

Availability 

Fireworks 3, enhanced in 4 

Description 

Adds one or more frames to the document. 

Arguments 

howMany, where, { bAdvanceActI veErame} 

• howMany is an integer that specifies how many frames to add. 

• where specifies where to add the frames. Acceptable values for where are "begi nni ng", 
"before current", "after current", and "end". 

• {bAdvanceActi veErame), which was added in Fireworks 4, specifies whether to change the 
active frame. If it is omitted or true, this function sets the active frame to the first frame 
added. If false, the active frame does not change. For example, if the user is adding frames at 
the end of a document that has two frames and bAdvanceActi veErame is omitted or true, 
then the third frame becomes the active frame. 

Returns 

Nothing. 

Example 

The following command adds one frame after the current frame but does not change the 
active frame. 

fw.getDocumentDOMl ) .addFramesd , "after current", false); 
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dom.addGuideO 

Availability 

Fireworks 3 

Description 

Adds a guide to the document. If a guide already exists at the specified position, this function 
has no effect. 

Arguments 

position, guide kind 

• pos 1 1 1 on is a float value that specifies the xory coordinate at which to add the guide. 

• Acceptable values for go 7 de/c 7 nd are "horizontal" and "verti cal ". IfgHidefand is 
"horizontal ", it is assumed that posi tion is a y coordinate; if "vert i cal ", it is an 
X coordinate. 

Returns 

Nothing. 

Example 

The following command adds a vertical guide at the x coordinate of 217. 
fw . getDocumentDOM( ) . addGui de( 217 , "vertical"); 

dom.addNewHotspotO 

Availability 

Fireworks 3 

Description 

Adds a new hotspot that fits into the specified bounding rectangle. 

Arguments 

hotspot-kind, hotspot-shape, boundi ngRectangl e 

• hotspot- k1 nd can be "hotspot" or "slice". 

• hotspot-shape can be " rectangl e" or "oval ". 

• boundi ngRectang 1 e is a rectangle that specifies the bounds within which the hotspot is placed 
(see “Rectangle” on page 6). 

Returns 

Nothing. 

Example 

The following command adds a new rectangle slice with the specified coordinates. 

fw . getDocumentDOM( ) . addNewHotspot ( "si i ce" , " rectangl e" , { 1 eft : 0 , top : 0 , 
right:50, bottom: 100 )) ; 
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dom.addNewImageO 

Availability 

Fireworks 3 

Description 

Adds a new empty (transparent) image to the document. 

Arguments 

boundl ngRectangl e , bEnterPal ntMode 

• boundi ngRectangl e is a rectangle that specifies the bounds of the image to be added (see 
“Rectangle” on page 6). You cannot create an image that is larger than the document; 
therefore, if you pass in a rectangle with bounds larger than the document size, you can create 
an image that is constrained to the document size. 

• If bEnterPa i ntMode is true, the application immediately enters bitmap mode for the new 
image. 

Returns 

Nothing. 

Example 

The following command adds an empty image that is 500 by 500 pixels in size, and then enters 
bitmap mode. 

fw . getDocumentDOMl ) . addNewImagel { 1 eft : 0 , top:0, right:500, bottom : 500 I , true): 

dom.addNewImageViaCopyO 

Availability 

Fireworks MX 

Description 

Adds a new image to the document containing the contents of the current paint-mode selection. 
The new image is placed directly above the active bitmap. You must have a current pixel selection 
for this to succeed. The new bitmap appears with Fireworks in paint mode. 

Arguments 

None. 

Returns 

Nothing. 

dom.addNewImageViaCutO 

Availability 

Fireworks MX 

Description 

Adds a new image to the document that contains the contents of the current paint mode 
selection. The new image is placed directly above the active bitmap. You must have a current pixel 
selection for this to succeed. The selection is cut from the previously active bitmap. The new 
bitmap appears with Fireworks in paint mode. 
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Arguments 

None. 

Returns 

Nothing. 

dom.addNewLayerO 

Availability 
Fireworks 3 

Description 

Adds a new layer to the document and makes it the current layer. 

Arguments 

name, bShared 

• name is a string that specifies the name for the new layer. If name is nul 1 , a new layer name 
is generated. 

• bShared is a Boolean value that specifies whether the new layer is shared. 

Returns 

A string value that contains the name of the new layer. 

Example 

The following command adds a new unshared layer with a default name that is generated 
by Fireworks. 

fw. g et Document DOM().addNew Lay er(null , false): 

dom.addNewLineO 

Avaiiability 

Fireworks 3 

Description 

Adds a new path between two points. The new path uses the document’s current default path 
attributes and is added to the current frame and layer. 

Arguments 

startPoint , endPoInt 

startPoint and endPoInt are points that specify the x,y coordinates between which the path is 
added (see “Point” on page 6). 

Returns 

Nothing. 

Example 

The following command adds a new line between the specified coordinates. 
fw.getDocumentDOM( ) .addNewLinel {x:64.5, y:279.5), {x:393.5, y:421.5)); 
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dom.addNewOvalQ 



Availability 

Fireworks 3 

Description 

Adds a new oval fitting into the specified bounding rectangle. The oval uses the document’s 
current default path attributes and is added on the current frame and layer. 

Arguments 

boundl ngRectangl e 

bound! ngRectangl e is a rectangle that specifies the bounds of the oval to be added (see 
“Rectangle” on page 6). 

Returns 

Nothing. 

Example 

The following command adds a new oval within the specified coordinates. 

fw . getDocumentDOM( ) . addNewOval ( { 1 eft : 72 , top:79, right:236, bottom:228) ) ; 

dom.addNewRectangleO 

Availability 

Fireworks 3 

Description 

Adds a new rectangle or rounded rectangle fitting into the specified bounds. The rectangle uses 
the document’s current default path attributes and is added on the current frame and layer. 

Arguments 

boundl ngRectangl e , roundness 

• boundi ngRectangl e is a rectangle that specifies the bounds within which the new rectangle is 
added (see “Rectangle” on page 6). 

• roundness is a float value between 0 and 1 that specifies the “roundness” to use for the corners 
(0 is no roundness, 1 is 100 percent roundness). 

Returns 

Nothing. 

Example 

The following command adds a new rectangle with no round corners within the 
specified coordinates. 

fw . getDocumentDOM( ) . addNewRectangl e( { 1 eft : 0 , top:0, rightilOO, bottom : 100 ) , 

0) : 

Related functions 

dom . addNewRectangl ePri mi ti ve( ) 
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dom.addNewRectanglePrimitiveO 

Availability 

Fireworks 4 

Description 

Adds a new rectangle primitive that fits into the specified bounds. The rectangle primitive uses 
the document’s current default path attributes, is added on the current frame and layer, and has 
several editable properties, such as corner roundness and transformation. The difference between 
a rectangle and a rectangle primitive is that a rectangle is a path that is shaped like a rectangle, and 
a rectangle primitive remembers its “rectangleness”; that is, if you drag a corner, it remains a 
rectangle, rather than deforming into a quadrilateral. 

Arguments 

boundl ngRectangl e , roundness 

• boundl ngRectangl e is a rectangle that specifies the bounds within which the new rectangle 
primitive is added (see “Rectangle” on page 6). 

• roundness is a float value between 0 and 1 that specifies the “roundness” to use for the corners 
(0 is no roundness, and 1 is 100 percent roundness). 

Returns 

Nothing. 

Example 

The following command adds a new rectangle primitive with no round corners within the 
specified coordinates. 

fw . getDocumentDOMl ).addNewRectanglePrimitive({left:0, top:0, rightilOO, 
bottom:100) , 0) ; 

Related functions 

dom.addNewRectanglel), fw.ungroupPrimitivesl) 

dom.addNewSinglePointPathO 

Availability 

Fireworks 3 

Description 

Adds a new path that consists of a single Bezier point. The path uses the default fill, stroke, and so 
on, and is added on the current frame and layer. The point is selected after it is added. 

Arguments 

control Po1 ntF1 rst , ma1 nPo1 nt , control Poi nttast , bCopyAttrs 

• control Po1 ntF1 rst, mainPoint, and control Po1 ntLast are points that specify the x,y 
coordinates of the preceding control point, the main point, and the following control point of 
the Bezier path (see “Point” on page 6). 

• If bCopyAttrs is f al se, the path’s stroke and fill are copied directly from the document’s 
current stroke and fill settings. If it is true, the path’s fill is set to None, and the brush is set to 
something other than None. 

Returns 

Nothing. 
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Example 

The following command adds a new path that consists of a single Bezier point at the specified 
coordinates and copies the paths stroke and fill from the document’s current stroke and fill 
settings. 

fw . getDocumentDOM( ) . addNewSi ngl ePoi ntPath ( { X : 150 , y:63), {x:150, y:63|, 

{x:150, y:63), false); 

dom.addNewStarO 

Availability 

Fireworks 3 

Description 

Adds a new star- or polygon-shaped path. 

Arguments 

numSIdes, sp1 ki ness , blsStar, centerPoi nt , outsidePoint 

• numSides is an integer that specifies the number of sides of the new path. 

• spi ki ness is 3. float value that controls the regularity of the star or polygon. Pass - 1 to have 
Fireworks calculate a good value, or pass a value between 0 and 1 for manual control. 

• IfhJsStaristrue,astar with the specified number of points is created. Ifitisfalse,a regular 
polygon with the specified number of sides is created. 

• centerPoi nt specifies the center point of the star or polygon (see “Point” on page 6). 

• outs i dePo i nt specifies a point on the radius of the star or polygon. 

Returns 

Nothing. 

Example 

The following command adds a five-sided star. 

fw.getDocumentDOM( ) .addNewStar(5, -1, true, {x:186, y:72), {x:265, y:89)); 

dom.addNewSymbolO 

Availability 

Fireworks 3 

Description 

Adds a new symbol to the library and opens the symbol document for editing. Optionally adds an 
instance of the symbol to the document. 

Arguments 

type, name, bAddToDoc 

• type can be "graphic", ''button'' , or "animati on". 

• name is a string that specifies the name of the symbol. 

• If bAddToDoc is true, an instance of the symbol is inserted into the center of the document. If 
fal se, the symbol is created in the document’s library, but no instance of the symbol is 
inserted into the document. 
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Returns 

Nothing. 

Example 

The following command adds a new graphic symbol called text to the library and places an 
instance of it in the document. 

fw . getDocumentDOM( ) . addNewSymbol ( "graphi c" , "text", true); 

dom.addNewT ext() 

Availability 

Fireworks 3 

Description 

Adds a new empty text block within the specified bounding rectangle. (To place text in the box, 
use dom. setTextRuns ( ).) 

Arguments 

boundl ngRectangl e , bln1 tFromPrefs 

• boundl ngRectang Je is a rectangle that specifies the bounds within which to place the new text 
box (see “Rectangle” on page 6). 

• If bini tFromPrefs is fal se, the default values for all style properties are used. If it is true, 
the most recent values set by the user are used. 

Returns 

Nothing. 

Example 

The following command adds a text box with the most recently used style properties. 

fw . getDocumentDOM( ) . addNewText ( { 1 eft : 43 , top:220, right:102, bottom : 232 ) , 
true ) : 

dom.addSwapImageBehaviorFromPointO 

Availability 

Fireworks 3 

Description 

If a single hotspot or slice is selected, this function adds to it a swap image behavior from the 
hotspot or slice located at where in the document. 

Arguments 

where 

where is a point that specifies the x,y coordinates of the hotspot or slice that contains the swap 
image behavior to be added (see “Point” on page 6). 

Returns 

true if the swap image behavior was added; false if no suitable hotspot was at the 
specified location. 
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dom.adjustExportToSizeO 



Availability 

Fireworks 3 

Description 

Adjusts the export settings as specified. 

Arguments 

s1 zelnBytes . bOkToIncreaseSi ze 

• s 1 zelnBytes is an integer that specifies the size to be used for exporting. It is used as described 
in the following list: 

If a document has no slices, s 1 zelnBytes adjusts the export settings for the current frame so 
that the image is less than or equal to si zelnBytes. 

If a document has slices, s i zelnBytes adjusts the size of all exported images so that the sum of 
the sizes is greater than or equal to si zelnBytes. 

• bOkToIncreaseSi ze specifies whether the export file size can be increased. 

If bOkToIncreaseSi ze is true, and the current size is less than sizeInBytes, the argument 
increases the quality of the export settings as much as possible, making the export size larger 
if necessary. 

If bOkToIncreaseSi ze is f al se, the argument increases the quality of the export settings as 
much as possible without increasing the export size. 

dom.adjustFontSizeO 

Availability 

Fireworks MX 

Description 

Increases (positive values) or decreases (negative values) the font size of selected text elements. If a 
text element has multiple font sizes, each size is adjusted independently. 

Arguments 

amount 

amount, which is specified in points, changes the font size. Positive values (such as ''2pt '') increase 
the size, while negative values (such as " - 1 p t " ) decrease the size. 

Returns 

Nothing. 

dom.alignO 

Availability 

Fireworks 3 

Description 

Aligns the selection. 

Arguments 

a 1 i gnmode 
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Acceptable values for a 1 1 gntnode are "left", "right", "top", "bottom", "center vertical", 
and "center horizontal". 

Returns 

Nothing. 

dom.appendPointToHotspotO 

Availability 

Fireworks 3 

Description 

Appends a point to the selected unclosed polygon hotspot. If an unclosed polygon hotspot is not 
selected, a new polygon hotspot is created with the single point that passed in. 

Arguments 

pt, tolerance 

• pt is a point that specifies the x,y coordinates of the point to be added (see “Point” on page 6). 

• tolerance ISA float value > = 0 that specifies the tolerance between the new point and the 
starting point of the polyline path. If the new point is within tolerance of the starting point, 
the polyline path is closed. 

Returns 

Nothing. 

dom.appendPointToPathO 

Availability 

Fireworks 3 

Description 

Appends a Bezier point to the selected path. 

Arguments 

contourlndex, ptTolnsertBefore, control Poi ntFi rst , mai nPo1 nt , control Po1 ntLast 

• contourlndex is a zero-based integer that specifies the contour to which the Bezier point is 
appended. For paths with multiple contours, the contours are in an arbitrary order. 

• ptTolnsertBefore is a zero-based integer that specifies where on the path the new point 
should be placed. The new point is appended in front of the point that this integer represents. 
To add a point to the beginning of the path, pass 0; to add a point to the end of the path, pass 
a large number. 

• control Po1 ntF1 rst, nia in Point, and control Poi ntLast are points that specify the x,y 
coordinates of the preceding control point, the main point, and the following control point of 
the new point (see “Point” on page 6). 

Returns 

Nothing. 

Related functions 

dom.insertPointInPath( ) 
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dom.appendPointToSliceO 

Availability 

Fireworks 3 

Description 

Appends a point to the selected unclosed polygon slice. If an unclosed polygon slice is not 
selected, then a new polygon slice is created with the single point that passed in. 

Arguments 

pt, tolerance 

• pt is a point that specifies the x,y coordinates of the point to be added (see “Point” on page 6). 

• tol erance is 3. float value > = 0 that specifies the tolerance between the new point and the 
starting point of the polyline path. If the new point is within tolerance of the starting point, 
the polyline path is closed. 

Returns 

Nothing. 

dom.applyCharacterMarkupQ 

Availability 

Fireworks 3, enhanced in 4 

Description 

Applies the specified character markup to the selected text. 

Arguments 

tag 

Acceptable values for tag are "b", " i ", and " u", for bold, italic, and underline: and "fwpl ai n", 
which was added in Fireworks 4, for text with no character markup. 

Returns 

Nothing. 

dom.applyCurrentFMIO 

Availability 

Fireworks 3 

Description 

Applies the document’s current fill to the selection. 

Arguments 

bNoNul 1 Fil 1 s 

bNoNul 1 Fi 1 1 s is true and the current fill is None, then a default fill is applied instead 
of no fill. 

Returns 

Nothing. 
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Example 

The following command applies the current fill to the selection, 
fw . getDocumentDOM( ).applyCurrentFill (true); 

dom.applyEffectsO 

Availability 

Fireworks 3 

Description 

Applies the specified effects to the selection. 

Arguments 

effectU St 

• effectU St is an EffectLi st object (see “EffectList” on page 29). 

• If effectUst is null, this function removes all effects from the selection. 

Returns 

Nothing. 

Example 

The following command applies a drop shadow with an angle of 315, a blur of 4, a color of black, 
and a distance of 7 (see “Drop Shadow” on page 26). 

fw . getDocumentDOM( ).applyEffects(lcategory:"Untitled", effects:! { 

Effect I sVi si ble: true, Ef f ectMoa ID : " { a7944db8-6ce2 - lldl -8c76000502701850 I" , 
ShadowAngl e : 315 , ShadowBl ur : 4 , ShadowCol or: "#000000a6" , ShadowDi stance : 7 , 
ShadowType : 0 , category : "Shadow and Glow", name:"Drop Shadow" ) ], 
name : "Unti tied" ) ) ; 

dom.applyFontMarkupO 

Availability 

Fireworks 3 

Description 

Applies the specified font markup attribute to the selected text. 

Arguments 

fontAttrl bute , value 

• Acceptable values for fontAttrl bute a.ce "size" and "face". 

• If fontAttrl bute is "size", i/a / ue must be of the form "XXXpt" to specify a point size; a 
simple numeric value is not allowed. 

Returns 

Nothing. 
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dom.applyStyleO 

Availability 

Fireworks 3 

Description 

Applies the specified style to the selection. 

Arguments 

sty] eName . styleindex 

• sty] eName is 3. string that specifies the style name to be applied. 

• style Index is usually zero. However, if there are multiple styles with the same name, 
styleindex is used to resolve the ambiguity (0 references the first style with that name, 

1 references the second, and so on). 

Returns 

Nothing. 

Example 

The following command applies the first style that Fireworks encounters named “Style 7”, which, 
in this case, is a default style. 

fw . getDocunientDOMl ) . appl yStyl e( "Styl e 7", 0); 

dom.arrangeO 

Availability 

Fireworks 3 

Description 

Arranges the selection. 

Arguments 

arrangemode 

Acceptable values for arrangemode are "back", "backward", "forward", and "front". 

Returns 

Nothing. 

Example 

The following command brings the selected items to the front, 
fw . getDocumentDOMl ). arrange! "front"); 

dom.attachT extT oPath() 

Availability 

Fireworks 3 

Description 

Attaches the selected text to the selected path. If no text and path are selected, no action occurs. 

Arguments 

None. 
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Returns 

Nothing. 

Example 

When two items are selected (one a text block and the other a shape), the following command 
attaches the text block to the shape’s path. 

f w. ge t Document DOM ( ) .attachTextToPath( ) ; 

dom.changeGuideO 

Availability 

Fireworks 3 

Description 

Moves a guide’s position to a new location. 

Arguments 

currentPosI t1 on , newPosition, guidekind 

• currentPos i t i on is a float value that specifies the current position of the guide. 

• newPos 7 1 7 on is a float value that specifies the new position of the guide. 

• Acceptable values for go 7 de/c 7 77d are "horizontal" and "verti cal ". If gu/de/c/nd is 
"hori zontal ", it is assumed that the specified positions are j coordinates; if guidekind is 
"vertical", it is assumed that the specified positions are x coordinates. 

Returns 

Nothing. 

Example 

The following command moves a vertical guide from position 135 to position 275. 
fw.getDocumentDOMl ) .changeGuide(135, 275, "vertical"); 

dom.changeSliceGuideQ 

Availability 

Fireworks MX 

Description 

Moves a slice guide’s position to a new location, which resizes any rectangular slices that abut the 
guide. A parameter controls whether slice guides that exist between the old position and the new 
one are also moved. 

If a slice is resized so that it has zero width or height, the slice is deleted. 

This function does not change slices that are not rectangular. 

Arguments 

currentPosi ti on, newPosition, guidekind, i sMagneti cDrag 

• currentPos i t i on is a float value that specifies the current position of the slice guide to be 
moved. 

• newPos 7 1 7 on is a float value that specifies the new position of the slice guide. 
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• gu1dek1 nd accepts values of “hori zontal ” or “vertical”. If gui dekind is “horizontal”, 
Fireworks assumes that the specified positions are j coordinates; if “vert i cal ”, the specified 
positions are x coordinates. 

• i sMagneti cDrag is a Boolean value that determines whether to move other slice guides 
between the old and new positions. If i sMagneti cDrag is true. Fireworks also moves slice 
guides between the old guide position and the new position. This action resizes and possibly 
deletes rectangular slices that do not abut the slice guide at currentPosi tion. 

Returns 

Nothing. 

Example 

The following command moves a vertical slice guide from position 135 to position 275, and 
moves all vertical slice guides between 135 and 275 to 275. 

fw.getDocumentDOMl ) .changeGuide(135, 275, "vertical", true); 

dom.clearJPEGMaskO 

Availability 

Fireworks 4 

Description 

Clears the “Selective JPEG mask” for the document. 

Arguments 

None. 

Returns 

Nothing. 

dom.clipCopyO 

Availability 

Fireworks 3 

Description 

Copies the selection to the Clipboard. 

Arguments 

None. 

Returns 

Nothing. 

Example 

The following command copies the selected items to the Clipboard, 
fw . getDocumentDOMl ) . cl i pCopy ( ) ; 
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dom.clipCopyAsPathsO 

Availability 

Fireworks MX 

Description 

Copies the selection to the Clipboard in Adobe Illustrator format. 

Arguments 

None. 

Returns 

Nothing 

Example 

The following command copies the selected items to the Clipboard in Adobe Illustrator format, 
fw. get Document DOM ( ) .cl i pCopyAs Paths ( ) ; 

dom.clipCopyFormatsO 

Availability 

Fireworks MX 

Description 

Copies the selection to the Clipboard using the specified format. 

Arguments 

format 

format defines the graphic format for the selection. For example, ''AICB” is the Adobe 
Illustrator format. 

Returns 

Nothing 

dom.clipCutO 

Availability 

Fireworks 3 

Description 

Cuts the selection to the Clipboard. 

Arguments 

None. 
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Returns 

Nothing. 

Example 

The following command cuts the selected items and places them on the Clipboard, 
fw. g et Document D0M( ) .cl i pCut( ) ; 

dom.clipPasteO 

Availability 

Fireworks 3, enhanced in 4 

Description 

Pastes the Clipboard contents into the document. 

Arguments 

{ whatif Resol utionDi fferent, whatlfPastlnglntoElementMask] 

• whatif Reso 1 utionDi fferent is an optional string that specifies how resampling should be 
done if the resolution of the Clipboard contents doesn’t match the resolution of the document. 
Acceptable values for whatif Resol uti onDi fferent are "resampl e", "do not resampl e", and 
"ask user" (displays a dialog box to let the user decide). If whatif Resol uti onDi fferent is 
omitted or n u 1 1 , " a s k u s e r " is assumed. 

• whatif Pa sti nglntoEl ementMask, which was added in Fireworks 4, applies only if the user 
is editing an element mask, and that element mask is an empty image mask. In this case, the 
pasted elements will replace the existing mask (because it is essentially a mask that doesn’t mask 
anything). If the image mask isn’t empty, the pasted elements are added to the existing mask, 
rather than replacing it. 

• Acceptable values for iv/7atJfPast7n5fJntof/emer)tAfas/c are "image", "vector", and "ask 
user". If whatif Pasti nglntoEl ementMask is omitted or nul 1, "ask user" is assumed. 

Returns 

Nothing. 

Example 

The following command pastes the Clipboard contents into the document. If there is a need for 
resampling. Fireworks asks the user to decide how to resample. 

fw. g et Document D0M( ) .cl i pPaste( ) ; 

dom.clipPasteAsMaskO 

Availability 

Fireworks 4 

Description 

Pastes the Clipboard contents into the document as an element mask. Only one element can be 
selected when calling this function. If selecting more than one element (or none) when this function 
is called. Fireworks throws an exception. An exception is also thrown if there is nothing on the 
Clipboard. 
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Arguments 

whatif Resol uti onDi fferent , niasktype, maskRepl aceOptions 

• whatIfResolutionDi fferent is a string that specifies how resampling should be done if the 
resolution of the Clipboard contents doesn’t match the resolution of the document. Acceptable 
values for w/73 tJf/iesoiut 7 onD? fferent are " resampl e", "do not resampl e", and 

"ask user" (displays a dialog box to let the user decide). If whatif Resol ut1 onD1 fferent is 
omitted or n u 1 1 , " a s k u s e r " is assumed. 

• masktype specifies how to paste the mask. Acceptable values are "image" (always paste as an 
image mask), "vector" (always paste as a vector mask), and "ask" (displays a dialog box to let 
the user decide). If the Clipboard contains a single image, it is pasted as an image mask, even if 
you pass "vector". 

• Acceptable values for maskRepl aceOpti on s are "replace" (if an element mask already exists, 
replace it with the pasted one), "add" (if an element mask already exists, add the pasted mask 
to it), and "ask" (displays a dialog box to let the user decide). 

Returns 

Nothing. 

dom.clipPasteAttributesO 

Availability 

Fireworks 3 

Description 

Pastes the attributes from the Clipboard onto the selection. 

Arguments 

None. 

Returns 

Nothing. 

Example 

The following command applies the attributes that were copied to the Clipboard onto the 

selected items. 

fw . getDocumentDOM( ) . cl i pPasteAttri butes ( ) ; 

dom.clipPasteFromChannelToChannelO 

Availability 

Fireworks MX 

Description 

Pastes the specified color channel on the Clipboard into each of the RGB channels of a new image 

or into the specified channel of the selected image, if any. 
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Arguments 

fromChannel , toChannel 

• If the current selection is not a single bitmap, a new opaque bitmap is created and the 
fromChanne 1 is pasted in to all three color channels of the new bitmap, resulting in a grayscale 
image. This first argument is ignored if the current selection is not a single bitmap. 

• If the currently selected element is a bitmap, the toChanne 1 argument is used to specify where 
to paste the color data. 

Returns 

Nothing. 

Example 

The following command copies the red data from the Clipboard into the red channel: 
fw . ge t Document DOM ( ) . cl i pPasteFromChannel ToChannel (" red" , " red" ) ; 

The following command copies the green data from the clipboard into the alpha channel: 
fw . getDocumentDOM( ) . cl i pPasteFromChannel ToChannel ("green", "alpha"); 

dom.clipPastelnsideO 

Availability 

Fireworks 3, deprecated in 4 in favor of dom. cl i pPasteAsMask( ) (see “dom.clipPasteAsMaskO” 
on page 75) 

Description 

Pastes the Clipboard contents into the selection, and makes the selected element into the element 
mask for the pasted element(s). If the selected element already has a mask, this function groups 
the pasted elements with the selected element and applies the existing element mask to the group. 

Arguments 

{ whatif Resol utionDi fferent] 

• whatif Re solutionDi fferent is an optional string that specifies how resampling should be 
done if the resolution of the Clipboard contents doesn’t match the resolution of the document. 
Acceptable values for wAat Jf/?eso Jut 7 onD? fferent are " resampl e", "do not resample", 
and "ask user" (displays a dialog box to let the user decide) . 

• If w/?at Jf/ieso Jut 7 07?D7 fferent is omitted or nul 1 , "ask user" is assumed. 

Returns 

Nothing. 

Example 

The following command pastes the Clipboard contents inside the selected items. If the resolution 
of the Clipboard doesn’t match the resolution of the document. Fireworks resamples the 
Clipboard contents to match the document. 

fw . getDocumentDOM( ) . cl i pPastelnsi de( " resampl e" ) ; 
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dom.cloneSelectionO 

Availability 

Fireworks 3 

Description 

Makes exact duplicates of the selection, placing the duplicated items directly on top of the 
original items. 

Arguments 

None. 

Returns 

Nothing. 

Example 

The following command copies the selected items on top of the original items, 
fw . getDocumentDOM( ).cloneSelection(); 

Related functions 

dom.duplicateSelection() 

dom.closeO 

Availability 

Fireworks 3 

Description 

Closes the document. 

Arguments 

bPromptToSaveChanges 

If bPromptToSa veChanges is true, and the document was changed since the last time it was 
saved, the user is prompted to save any changes to the document. If bPromptToSa veChanges is 
fal se, the user is not prompted, and changes to the document are discarded. 

dom.convertAnimSymbolToGraphicSymbolO 

Availability 

Fireworks 4 

Description 

If a single animation symbol is selected, this function converts it from an animation symbol to a 
graphics symbol. 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom.convertToAnimSymbol ( ) , dom. convertToSymbol ( ) 
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dom.convertToAnimSymbolO 

Availability 

Fireworks 4 

Description 

Converts the selected item(s) to a new animation symbol. 

Arguments 

name, numFrames, offsetDIstPt, rotati onAmount , sea 1 eAmount , startOpaci ty , 
endOpad ty 

• name is a string that specifies a name for the new animation symbol. 

• numFrames is an integer that specifies the number of frames through which the 
symbol animates. 

• OffsetDIstPt is a point that specifies the distance the animation will move in pixels (see 
“Point” on page 6). For example, passing ({x:100, y:25}) animates the symbol to the right 100 
pixels and down 25 pixels. 

• rotati onAmoun t is a float value that specifies the degrees of rotation to be applied to the 
animation symbol. For example, passing 720 specifies an animation that does two complete 
clockwise rotations. To rotate the animation counter-clockwise, pass a negative number. 

• seal eAmount is a positive float value that specifies the amount of scaling to be applied to the 
animation symbol. For example, passing 50 scales the symbol to 50 percent of its current size, 
and passing 200 scales it to twice its current size. To specify no scaling, pass 100. 

• StartOpaci ty and endOpaci ty are float values between 0 and 100 that specify the starting 
and ending opacity for the animation symbol. 

Returns 

Nothing. 

Related functions 

dom . convertAni mSymbol ToGraphi cSymbol ( ) , dom. convertToSymbol ( ) , 
dom.setAnimInstanceNumFrames( ) 

dom.convertT oPaths() 

Availability 

Fireworks 3 

Description 

Converts the selected text items into editable paths. 

Arguments 

None. 

Returns 

Nothing. 

Example 

The following command converts the selected text items into editable paths. 

f w. ge t Document DOM ( ) . convertToPaths ( ) ; 
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dom.convertT oSymbol() 

Availability 

Fireworks 3 

Description 

Converts the selected item(s) to a new symbol. 

Arguments 

type, name 

• Acceptable values for type ace "graphic", "button", and "animation". 

• name specifies a name for the new symbol. 

Returns 

Nothing. 

Example 

The following command creates a graphic symbol from the selected item and names it “star”, 
fw . getDocumentDOM( ) . convertToSymbol ("graphic", "star" ) ; 

Related functions 

dom . convertToAni mSymbol ( ) , dom. convertAni mSymbol ToGraphi cSymbol ( ) 

dom.copyHtmlWizardO 

Availability 

Fireworks MX 

Description 

Launches the Copy HTML Wizard dialog box. 

Arguments 

None. 

Returns 

Nothing. 

Example 

The following command launches the Copy HTML Wizard dialog box: 
fw . getDocumentDOM( ) . copyHtml Wi zard ( ) ; 

dom.copyT oHotspot() 

Availability 

Fireworks 3 

Description 

Creates one or more hotspots from the selection. 



80 Chapters 




Arguments 

hotspotType . { whatlfMultl pi eSel ected] 

• Acceptable values for hotspotType zee "hotspot" and "slice". 

• whatlfMul ti p] eSel ected is an optional string that specifies how to create hotspots if 
multiple items are selected. Acceptable values for what If Mu 1 ti pi eSel ected are "single" 
(creates a single hotspot that has the same bounding rectangle as the selection), "mul ti pi e" 
(creates one hotspot for each item), and "ask user" (displays a dialog box to let the user 
decide). 

• If whatlfMu 1 ti pi eSel ected is omitted or nul 1 , "ask user" is assumed. 

Returns 

Nothing. 

Example 

The following command adds a hotspot to the selected item. If more than one item is selected. 
Fireworks creates one hotspot for each item. 

fw . getDocumentDOMl ) . copy ToHots pot ( "hotspot" , "multiple"); 

dom.cropSelectionO 

Availability 

Fireworks 3 

Description 

Crops the selection to the specified rectangle. 

Arguments 

boundl ngRectangl e 

bound! ngRectangl e is a rectangle that specifies the bounds within which the selection should be 
cropped (see “Rectangle” on page 6). 

Returns 

Nothing. 

dom.deleteAllInDocumentO 

Availability 

Fireworks MX 

Description 

Deletes all the objects in the document. 

Arguments 

None. 

Returns 

Nothing. 
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dom.deleteFramesO 

Availability 

Fireworks 3 

Description 

Deletes one or more frames. 

Arguments 

framelndex, howMany 

• framelndex is a zero-based integer that specifies the location at which to begin deleting 
frames. To specify the current frame, pass -1. 

• howMany specifies how many frames to delete. 

Returns 

Nothing. 

dom.deleteLayerO 

Availability 

Fireworks 3 

Description 

Deletes a layer. 

Arguments 

1 ayer Index 

1 ayer Index is a zero-based integer that specifies the layer to be deleted. To specify the current 
layer, pass - 1 . 

Returns 

Nothing. 

Example 

The following command deletes the current layer, 
fw . ge t Document DOM ( ) . del ete Layer! - 1 ) ; 

dom.deletePointOnPathO 

Availability 

Fireworks 4 

Description 

Deletes the specified point on the currently selected path. If the point is the only one on its 
contour, the entire contour is deleted. If the point is the only one in the path, the entire path is 
deleted. The specified point does not need to be selected. 
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Arguments 

contourindex, po1 ntindex 

• contourindex is a zero-based integer that specifies the contour that contains the point to be 
deleted. To specify the current contour, pass - 1 . 

• point Index is a zero-based integer that specifies the point to be deleted. To specify the current 
point, pass -1. 

Returns 

Nothing. 

Example 

The following command deletes the currently selected point, 
fw . getDocumentDOM( ).deletePointOnPath(-l, -1); 

dom.deleteSelectionO 

Availability 

Fireworks 3 

Description 

Deletes the selection, or the pixel selection if Fireworks is in bitmap mode. 

Arguments 

bF1 1 1 Del etedArea 

• bn 1 1 Del etedArea is ignored if Fireworks is not in bitmap mode. 

• If Fireworks is in bitmap mode and bFi 1 1 Del etedArea is true, the deleted pixels are filled 
with the current fill color. If fal se, the deleted pixels are filled to transparent. 

Returns 

Nothing. 

Example 

If Fireworks is not in bitmap mode, the following command deletes the selected items. 

If Fireworks is in bitmap mode, the following command fills the selected items to transparent. 

f w. ge t Document DOM ( ).deleteSelection(false); 

dom.deleteSymbolO 

Availability 

Fireworks 3 

Description 

Deletes the specified symbols from the library. 
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Arguments 

symbol Name 

symbo 1 Name is the name of the symbol to delete from the library. If more than one symbol exists 
with this name, only the first symbol is deleted. 

• To delete all the selected symbols from the library (not document), pass null. 

• If the deleted symbols contain any active instances in the document, the instances are also 
deleted. 

Returns 

Nothing. 

Example 

The following command deletes the selected symbols from the library as well as any active 
instances from the document. 

f w. ge t Document DOM ( ) .del eteSymbol (null ) ; 

dom.detachInstanceFromSymbolO 

Availability 

Fireworks 3 

Description 

Breaks the links between the selected instances and the owning symbols. 

Arguments 

None. 

Returns 

Nothing. 

dom.detachT extFromPath() 

Availability 

Fireworks 3 

Description 

Splits the selected text-on-a-path items into its original text and path items. 

Arguments 

None. 

Returns 

Nothing. 
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dom.distributeO 



Availability 

Fireworks 3 

Description 

Distributes the selection along a vertical or horizontal dimension. 

Arguments 

dmens 1 on 

Acceptable values for d 7 ff?eA7s 7 on are "vertical" and "horizontal". 

Returns 

Nothing. 

dom.distributeLayerToFramesO 

Availability 

Fireworks 3 

Description 

Distributes the items on the specified layer to the frames of the document, adding frames if 
necessary. The first item on the layer goes to the first frame, the second item to the second frame, 
and so on. New frames are added to the document, if necessary. If there is only one item in the 
specified layer, this function has no effect. 

Arguments 

1 ayer Index 

1 ayer Index is a zero-based integer that specifies the layer that contains the items to be 
distributed. To specify the current layer, pass - 1 . 

Returns 

Nothing. 

dom.distributeSelectionToFramesO 

Availability 

Fireworks 3 

Description 

Distributes the selected items to the frames of the document, adding frames if necessary. The first 
item goes to the current frame, the second item to the next frame, and so on. If only one item is 
selected, this function has no effect. 

Arguments 

None. 

Returns 

Nothing. 
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dom.duplicateFrameO 



Availability 

Fireworks 3 

Description 

Duplicates a frame. 

Arguments 

frameindex , howMany, where, bDupeSel ect1 onOnly 

• frameindex is a zero-based integer that specifies the frame to duplicate. To specify the current 
frame, pass - 1 . 

• howMany is an integer that specifies how many copies of the frame to make. 

• Acceptable values for iv/iere are "beginning'', "before current", "after 
current", and "end". 

• If bOupeSe 1 ecti onOn ly is true, only items in the specified frame that are selected are duplicated 
to the new frame. 

Returns 

Nothing. 

Example 

The following command makes one copy of the current frame and places the new frame after the 
current frame. 

fw. getDocumentDOM( ) . dupl i cateFramel - 1 , 1, "after current", false); 

dom.duplicateLayerO 

Availability 

Fireworks 3 

Description 

Duplicates a layer. 

Arguments 

1 ayerindex, [howMany], [where] 

• ] ayerl ndex is a zero-based integer that specifies the layer to duplicate. To specify the current 
layer, pass - 1 . 

• howMany is an optional integer that specifies how many times to duplicate the layer. If omitted, 
the layer is duplicated once. 

• where is an optional argument that specifies where to put the new layer(s) in relation to the 
source layer. Acceptable values are "begi nni ng" , "before current", "after current", 
and "end". If omitted, "before current" is assumed. 

Returns 

Nothing. 
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Example 

The following command places three copies of the current layer at the end of the document. 
fw.getDocumentDOM( ) .dupl icateLayer( -1 , 3, "end"); 

dom.duplicateSelectionO 

Availability 

Fireworks 3 

Description 

Makes a duplicate of the selection, offsetting it slightly from the original. 

Arguments 

None. 

Returns 

Nothing. 

Example 

The following command duplicates the selected items, 
f w. ge t Document DOM ( ).duplicateSelection(); 

Related functions 

dom.cloneSelection() 

dom.duplicateSelectionToFrameRangeO 

Availability 

Fireworks 3 

Description 

Duplicates the selection to a range of frames of the document. 

Arguments 

frameIndexFI rst , frameIndexLast 

framelndexFI rst and frameIndexLast are zero-based integers that specify the range of frames 
(inclusive) to which the items should be copied. To specify the current frame, pass - 1 . 

• If both arguments are the same, duplicates are placed only on that frame. 

• If the range includes the current frame, duplicates are not placed on that frame. 

Returns 

Nothing. 

dom.duplicateSelectionToFramesO 

Availability 

Fireworks 3 

Description 

Duplicates the selection to specified frames of the document. 
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Arguments 

wh1 chFrames 

• Acceptable values for wh1 chFrames are "all", "previous", "next", and "end". 

• Note that " end " means the last frame of the document; it does not add a new frame. 

Returns 

Nothing. 

dom.duplicateSymbolO 

Availability 

Fireworks 3 

Description 

Duplicates the specified symbol. 

Arguments 

symbol 

symbol is the symbol to duplicate. 

• To duplicate all selected symbols in the library (not the document), pass a nul 1 value. 

• Duplicating a linked symbol results in a nonlinked duplicate. 

Returns 

Nothing. 

dom.duplicateSymbolForAliasO 

Availability 

Fireworks 3 

Description 

If any symbol instances are selected, this function makes duplicate symbols of all the symbols that 
are pointed to by those instances. The selected instances are updated to point to the new duplicate 
copies of the symbols. Duplicate symbols always result in nonlinked duplicates. (The use of the 
word “alias” in the function name corresponds to an “instance” in a Fireworks document.) 

Arguments 

None. 

Returns 

Nothing. 

dom.enableElementMaskO 

Availability 

Fireworks 4, updated with new arguments in Fireworks MX 

Description 

Enables or disables the element mask on the selected element. Only one element can be selected 
when calling this function. If selecting more than one element (or none) at the time this function 
is called. Fireworks throws an exception. 
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Arguments 

enable, selectAndEnterPaintModelfPossible, newSel ect1 onMask 

• enabl e is a Boolean value that toggles the element mask between enabled (true) and disabled 
(fal se). 

• selectAndPnterPaintModelfPossible is a Boolean value that determines the mode for the 
mask. If se i ectAndPnterPa 1 ntModelfPoss 1 bl e is true , and the mask is a bitmap mask, 
then bitmap mode is entered for the mask. It is false by default. 

• newSel ect1 onMask is an optional bitmap selection mask. If newSel ecti onMask is not nul 1, 
and selectAndEnterPaintModelfPossible is true, the selection will be set on the mask 
after entering paint mode. newSel ecti onMask is nuM by default. 

Returns 

Nothing. 

dom.enableT extAntlAliasingO 

Availability 

Fireworks MX 

Description 

Turns anti-aliasing on or off for the selected blocks of text. 

Note: To set the level of anti-aliasing, call “dom.setTextAntiAllasIngO” on page 159. 

Arguments 

antlAl las 

anti A 1 i as is a Boolean value to turn anti-aliasing on (true) or off (fal se). 

Returns 

Nothing. 

dom.enterElementMaskEditModeO 

Availability 

Fireworks 4 

Description 

Places Fireworks in element-mask edit mode for the selection. If the selection contains no mask 
elements. Fireworks throws an exception. 

Arguments 

None. 

Returns 

Nothing. 
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dom.enterPaintModeO 



Availability 

Fireworks 3, with the argument newSel ecti onMask added in Fireworks MX. 

Description 

Enters image edit mode on the selected items. Has no effect if nothing is selected or if a nonimage 
item is selected. 

Arguments 

newSel ect1 onMask 

newSel ect1 onMask is an optional bitmap selection mask. When newSel ect1 onMask is not null, 
the selection is set on the currently selected bitmap after entering paint mode. 
newSel ect1 onMask is nul 1 by default. 

Returns 

Nothing. 

dom.exitElementMaskEditModeO 

Availability 

Fireworks 4 

Description 

Takes Fireworks out of element-mask edit mode. If Fireworks is not in this mode, this function 
has no effect. 

Arguments 

None. 

Returns 

Nothing. 

dom.exitPaintModeO 

Availability 

Fireworks 3 

Description 

Leaves bitmap mode. Has no effect if Fireworks is not in bitmap mode. 

Arguments 

None. 

Returns 

Nothing. 
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dom.exportOptions.loadColorPaletteO 

Availability 

Fireworks 3 

Description 

Replaces the values in dom.exportOpt ions. pal etteEntri es with those in the specified GIF or 
ACT file. This function also sets dom . exportOpti ons . pal etteMode to "custom". For more 
information, see “ExportOptions” on page 33. 

Arguments 

fileURL 

fi 1 eilRL is a string, which is expressed as a file://URL, that specifies the GIF or ACT file that is 
used to replace the color panel. 

Returns 

true if the file is read successfully; f al se if the file is not the expected format or is not read 
successfully for any other reason. 

dom.exportOptions.saveColorPaletteO 

Availability 

Fireworks 3 

Description 

Saves the values in dom. exportOpti ons . pal etteEntri es to the specified color panel (ACT 
file). This function does not modify the document. For more information, see “ExportOptions” 
on page 33. 

Arguments 

fileURL 

fi 1 eilRL is a string, which is expressed as a file://URL, that specifies the name of the file to 
which the color panel should be saved. Do not specify a file extension; the .act extension is 
added automatically. 

Returns 

Nothing. 

dom.exportToO 

Availability 

Fireworks 3 

Description 

Exports the document as specified. 
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Arguments 

fUeURL, { exportOpti ons] 

• f 7 1 eURL is a string, which is expressed as a File://URL, that specifies the name of the exported 
file. 

• exportOpti ons (optional) is an ExportOpti ons object (see “ExportOptions” on page 33). If 
this argument is omitted or nul 1 , the document’s current Export Options settings are used. If 
values are passed in with exportOpti ons, they are used for this export operation only; they do 
not change the document’s exportOpti ons property. 

Returns 

true if the file is successfully exported; false otherwise. 

dom.fillSelectedPixelsO 

Availability 

Fireworks 3 

Description 

When the selection is an image and Fireworks is in bitmap mode, this method fills the selected 

pixels with the current fill or generates a new pixel selection. 

Arguments 

clIckPt, pi. p2, p3, bFin Sel ecti onOnI y , tolerance, edgemode, featherAmt 

• cl i ckPtis A point that specifies the x,y coordinates of the pixel to be filled or generated (see 
“Point” on page 6). 

• pi, pZ, and p3 are points that specify the fill- vector. These arguments are ignored if the current 
fill does not use a fill-vector. 

• If bFi 1 1 Sel ecti onOnl y is true, the remaining arguments are ignored. If it is f al se, the 
current pixel selection is ignored, and a new one is generated using the values passed for 
tolerance, edgemode, and featherAmt. (This behavior is the same as if the Magic Wand tool 
were used at the cl ickPt location.) 

• tolerance is an integer between 0 and 255, inclusive, that specifies the tolerance for 
selecting pixels. 

• Acceptable values for edgemode are "hard edge", " a n t i a 1 i a s " , and "feather". 

• featherAmt is an integer between 0 and 32,000, inclusive, that specifies the number of pixels 
to feather. This value is ignored if edgemode is not "feather". 

Returns 

Nothing. 

Example 

The following command fills the selection with a hard edge, and the tolerance set to 32. 

fw . getDocumentDOM( ) . f i 1 1 Sel ectedPi xel s ( { X : 207 , y:199), {x:207, y:199), {x:207, 
y:199), {x:207, y:199), false, 32, "hard edge", 0); 
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dom.filterSelectionQ 

Availability 

Fireworks 3 

Description 

Applies the specified pixel filter to the selection. Nonimage items are converted into images before 
the filter is applied. Only external filters that are capable of also being Live Effects can be applied 
using this function. To apply other types of external filters, use dom.filterSelectionByNamel). 

Arguments 

L 1 veEffect 

L 7 veEffect is an Effect object (see “Effect” on page 23). 

Returns 

Nothing. 

Example 

The following command runs the selected pixels through the hue/saturation filter and then sets 
hue to 30 and saturation to 20. 

fw . getDocumentDOMl ) . f i 1 terSel ecti on ( { 

EffectMoalD: ''{3439b08d -1922-1 Id3-9bde00e02910cl5801" , 

hi s_col ori ze : true , hue_amount : 30 , 1 i ghtness_amount : 0 , saturati on_amount : 20 
I): 

dom.filterSelectionByNameO 

Availability 

Fireworks 3 

Description 

Applies the specified pixel filter to the selection as a permanent action, not as a Live Effect. (To 
apply filters that can also be Live Effects, you can use dom . f i 1 terSel ecti on ( ).) This function 
always displays a dialog box. 

Arguments 

category, name 

• category is a string that specifies the category of the pixel filter to be applied. Acceptable 
values depend on which filters you have installed. 

• name is a string that specifies the name of the pixel filter to be applied. Acceptable values 
depend on which filters you have installed. 

Returns 

Nothing. 

dom.findExportFormatOptionsByNameO 

Availability 

Fireworks 3 

Description 

Looks for a set of export settings that were saved with the specified name. 
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Arguments 

name 

name is a string that specifies the name of the set of export settings to find. 

Returns 

If there is a set of export settings with the specified name, the argument returns an object that 
represents it; otherwise, it returns null. 

dom.findNamedElementsO 

Availability 

Fireworks 4 

Description 

Looks for elements that have the specified name. 

Arguments 

name 

name is a case-sensitive string that specifies the exact element name to find. To specify elements 
that have no name, pass null. 

Returns 

An array of elements that have the specified name, or nul 1 if no objects have the specified name. 

Related functions 

dom . setEl ementNamel ) 

dom.flattenDocumentO 

Availability 

Fireworks 3 

Description 

Flattens the entire document into a single pixel image. This is the same behavior as the Merge 
Layers command. 

Arguments 

None. 

Returns 

Nothing. 

dom.flattenSelectionO 

Availability 

Fireworks 3 

Description 

Flattens the selection into a single pixel image. This action is the same behavior as the Merge 
Images command. 
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Arguments 

None. 

Returns 

Nothing. 

dom.getFontMarkupO 

Availability 

Fireworks 3 

Description 

Gets a font markup attribute for the selected text. 

Arguments 

fontAttri bute 

Acceptable values for fontAttri bute are ''size”, "col or", and "face". 

Returns 

A string that specifies the markup value. Returns null if the text has multiple attributes or if the 
selection contains no text. 

dom.getPixelMaskO 

Availability 

Fireworks 3, deprecated in 4 

Description 

Gets the current pixel-selection mask. The result of this call could be used to call 
“dom.enableElementMaskO” on page 88 or “dom.enterPaintModeO” on page 90. 

Arguments 

None. 

Returns 

The mask for the current pixel selection. Returns null if Fireworks is not in bitmap mode, or if 
there is no pixel selection. For information on the format of mask variables, see “Mask” on page 6. 

dom.getSelectionBoundsO 

Availability 

Fireworks 3 

Description 

Gets the bounding rectangle of the selection. 

Arguments 

None. 

Returns 

A rectangle (see “Rectangle” on page 6). Returns null if nothing is selected. 
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dom.getShowGridO 

Availability 

Fireworks 3 

Description 

Determines if the grid is visible. 

Arguments 

None. 

Returns 

true if the grid is visible; false otherwise. 

dom.getShowRulersO 

Availability 

Fireworks 3 

Description 

Determines if the rulers are visible. 

Arguments 

None. 

Returns 

true if the rulers are visible; false otherwise. 

dom.getSnapT oGrid() 

Availability 

Fireworks 3 

Description 

Determines if the Snap to Grid function is active. 

Arguments 

None. 

Returns 

true if the Snap to Grid function is active; fal se otherwise. 

dom.getTextAlignmentO 

Availability 

Fireworks 3 

Description 

Gets the alignment of selected text. 
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Arguments 

None. 

Returns 

One of the following strings: "left", "center", "right", "justify", "stretch", "vertical 
left", "vertical center", "verti cal right", "verti cal justi fy", or "verti cal 
stretch". Returns null if the text has multiple alignments or if the selection contains no text. 

dom.groupO 

Availability 

Fireworks 3, argument deprecated in 4 

Description 

Groups the selection. To ungroup elements use dom. ungroupi ) (see “dom.ungroupO” on page 
168). 

Arguments 

{ type] 

type is an optional string that specifies how to group the items. Acceptable values are "normal ", 
"mask to image", and "mask to path". If the argument is omitted, "normal " is assumed, 
"mask to image" and "mask to path" are deprecated in Fireworks 4. 

Returns 

Nothing. 

Example 

The following command sets the selected group to mask to the image, 
replace with fw. getDocumentDOMl ). group! "normal ") ; 

dom.hasCharacterMarkupO 

Availability 

Fireworks 3, enhanced in 4 

Description 

Determines if the selected text has the specified character markup. 

Arguments 

tag 

Acceptable values for tag are "b", " i ", and " u", for bold, italic, and underline; and "fwpl ai n", 
which was added in Fireworks 4, for text without character markup. 

Returns 

true if the text has the specified character markup; fal se if it does not or if only part of the text 
has the markup. 
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dom.hideSelectionO 

Availability 

Fireworks 3 

Description 

Hides the selection. To redisplay it, use dom . showAl 1 Hi dden ( ). 

Arguments 

None. 

Returns 

Nothing. 

dom.importFileO 

Availability 

Fireworks 3 

Description 

Imports the specified file at the specified location. 

Arguments 

fUeURL, boundi ngRectangl e , bMai ntai nAspectRati o 

• f 7 1 eilRL is the filename of the file to be imported, which is expressed as a file://URL. 

• boundi ngRectangl e is a rectangle that specifies the size to make the imported file (see 
“Rectangle” on page 6). l( boundi ngRectangl e is speci£iedwkh left == right and 
top == bottom, the file is brought in unsealed with its top-left corner at the specified 
location, and the third argument is ignored. 

• bMa 1 ntai nAspectRati 0 is true, the file is scaled to the largest size that fits within 

boundi ngRectangl e while retaining the file’s current aspect ratio. (This is a handy option for 
creating thumbnails.) If it is fal se, the file is scaled to fill boundi ngRectangl e. 

Returns 

Nothing. 

Example 

The following command imports the specified file and maintains its aspect ratio. 

fw . getDocumentDOM( ) . i mportFi 1 e( "f i 1 e : ///C | /i mages/f oo . psd" , {1 eft : 25 , top : 50 , 
right:100, bottom:250), true); 

dom.importSymbolO 

Availability 

Fireworks 3 

Description 

Imports the specified external graphics file (for example, GIF, JPEG, or Fireworks document) into 
the library of the document. 
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Arguments 

fileURL, bAddToDoc, bAllowUI 

• f 7 1 eilRL is the name of the file to be imported into the library, which is expressed as a file:// 
URL. 

• If bAddToDoc is true, the symbol is added to the library and an instance of the symbol is 
inserted into the center of the document. If it is f al se, the symbol is added only to the library. 

• If bAl 1 owUI is true, and fi 1 eURL is a Fireworks document that contains symbols, then a 
dialog box lets the user specify which symbols to import from the external file. If it is f al se, all 
the symbols in the external file are imported. 

Returns 

Nothing. 

dom.importSymbolButNotAsAliasO 

Availability 

Fireworks MX 

Description 

dom . i mportSymbol ButNotAsAl i as extracts the component elements from the selected symbol 
and places copies of those elements in the document. 

This function is similar to the dom. i mportSymbol API. dom . i mportSymbol places an instance of 
a symbol in your document — for example, when you select Edit > Libraries > Buttons, and 
dom . i mportSymbol ButNotAsAl i as extracts the component elements from the selected symbol 
and places copies of those elements in the document, dom. i mportSymbol ButNotAsAl i as does 
not place in an instance in the document. 

Arguments 

fUepath, whi chSymbo 1 

• fi 1 epath is the f1 1 eURL of the file that contains the symbol to be copied. 

• wh i chSymbo 1 is the index of the symbol within the document, which is specified in 
the fi 1 epath. 

Returns 

Nothing. 

dom.inLaunchAndEditO 

Availability 

Fireworks MX 

Description 

Identifies if the document was opened by a Launch and Edit operation. 

Arguments 

None. 

Returns 

A Boolean value: true if opened by a Launch and Edit operation; false otherwise. 
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dom.insertPointInPathO 

Availability 

Fireworks 3 

Description 

Inserts a Bezier point in the selected path. This function is similar todom.appendPointToPath() 
but includes a tParameter argument, which lets you control where the point is inserted. 

Arguments 

contourindex, ptTolnsertBefore, tParameter , control Poi ntPi rst , ma1nPo1nt, 
control Po1 nttast 

• contourindex is a zero-based integer that specifies the contour into which the Bezier point is 
inserted. For paths with multiple contours, the contours are in an arbitrary order. 

• ptTolnsertBefore is a zero-based integer that specifies where the new point should be placed 
on the path. The new point is appended in front of the point that this integer represents: To 
add a point to the beginning of the path, pass 0; to add a point to the end of the path, pass a 
large number. 

• tParameter is a float value between 0 and 1 that specifies where to insert the new point in the 
Bezier segment. 

• control Po1 ntF1 rst, ma in Point, and control Poi ntlast are points that specify the x,y 
coordinates of the preceding control point, the main point, and the following control point of 
the new point (see “Point” on page 6). 

Returns 

Nothing. 

Related Functions dom.appendPointToPath( ) 

dom.isSelectionDirectlyAboveBitmapObjectO 

Availability 

Fireworks MX 

Description 

Tests to see if the selected object(s) are directly above a bitmap object. The selection does not need 
to be contiguous, although at least one item in the selection must be directly above a bitmap. 

Arguments 

None. 

Returns 

A Boolean value: true if the selected objects are directly above an image element; 
false otherwise. 

dom.joinPathsO 

Availability 

Fireworks 3 

Description 

Joins the selected paths. 
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Arguments 

None. 

Returns 

Nothing. 

dom.knifeElementsFromPointO 

Availability 

Fireworks 3 

Description 

When the user clicks a single point while using the Knife tool, this function cuts additional items 
within the specified tolerance. This action is similar to using the Knife tool with a single click. 

Arguments 

from, tolerance 

• from is a point that specifies the x,y coordinates of the point that the user clicked (see “Point” 
on page 6). 

• tolerance ISA float value > = 0 that specifies the tolerance within which items are cut. 

Returns 

true if anything was cut; false otherwise. 

Related functions 

dom . kni feEl ements FromPoi nts ( ) 

dom.knifeElementsFromPointsO 

Availability 

Fireworks 3 

Description 

When the user drags while using the Knife tool, this function cuts additional items within the 
specified tolerance. This action is similar to using the Knife tool with a Drag operation. 

Arguments 

from, to, tolerance 

• from is a point that specifies the x,y coordinates of the point where the user clicked and started 
to drag (see “Point” on page 6). 

• to is a point that specifies the x,y coordinates of the point where the user ended the Drag 
operation. 

• tol erance is A float value > = 0 that specifies the tolerance within which items are cut. 
Returns 

true if anything is cut; false otherwise. 

Related functions 

dom . kni feEl ements EromPoi nt ( ) 
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dom.linkElementMaskO 

Availability 

Fireworks 4 

Description 

Links or unlinks the element mask on the selected element. Only one element can be selected 
when calling this function. If selecting more than one element (or none) at the time this function 
is called, Fireworks throws an exception. An exception is also thrown if the element has no 
element mask. 

Arguments 

frame, layer, element, bLink 

• frame is a zero-based integer that specifies the frame that contains the element. To specify the 
current frame, pass -1. 

• 1 ayer is a zero-based integer that specifies the layer that contains the element. To specify the 
current layer, pass -1. 

• e 1 ement is a zero-based integer that specifies the element. To specify the current element, pass 
- 1 . 

• If bLink is true, the element masks are linked to their elements; if fal se, they are unlinked 
from their elements. 

Returns 

Nothing. 

dom.makeFindO 

Availability 

Fireworks 3 

Description 

Creates an object of class Fi nd to perform a fmd-and-replace operation in this document. 

Arguments 

fIndSpec 

findSpec is a Fi nd object (see “Find” on page 15). 

dom.makeGoodNativeFilePathO 

Availability 

Fireworks 3 

Description 

Ensures that the specified file URL ends in a .png extension. Does not affect the name of the file 
on disk. 

Arguments 

fileURL 

fi 1 eURL is the name of the file, which is expressed as a file://URL, whose extension should be 
changed to .png. 
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Returns 

A string that contains the file URL with a .png extension. 

Example 

The following command returns "file:///My Documents/imageOl.png". 

fw . getDocumentDOM( ).makeGoodNativeFilePath("file:///My Documents/imageOl.png'') 

dom.makeActiveO 

Availability 

Fireworks 3 

Description 

Makes the selected document active for editing. 

Arguments 

None. 

Returns 

Nothing. 

dom.mergeDownO 

Availability 

Fireworks MX 

Description 

Merges selected objects to the bitmap directly below the selected objects. Succeeds only if the 
object immediately below the selection is a bitmap. See 
“dom.isSelectionDirectlyAboveBitmapObjectO” on page 100. 

Arguments 

None. 

Returns 

Nothing. 

dom.modifyPointOnPathO 

Availability 

Fireworks 3 

Description 

Modifies an existing point on the selected path. 

Arguments 

contourindex, ptToModI fy, control Poi ntFi rst , mainPoint, control Po1 ntLast , 
dReappl yAttrs . bCl osePath 

• contourindex is a zero-based integer that specifies the contour into which the B&ier point is 
inserted. For paths with multiple contours, the contours are in an arbitrary order. 

• ptToModi fy is a zero-based integer that specifies the point to be modified. 
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• control Po1 ntF1 rst, ma in Point, and control Poi nttast are points that specify the x,y 
coordinates of the preceding control point, the main point, and the following control point of 
the new point (see “Point” on page 6). 

• If dReappl yAttrs is true, the path has the document’s current fill, stroke, and so on reapplied 
to it. If it is false, the path attributes are not changed. 

• If bCl osePath is true, the path is marked as closed after modifying the point. If it is fal se, 
the path retains its original open or closed value. 

Returns 

Nothing. 

dom.moveBezierHandleByO 

Availability 

Fireworks 3 

Description 

Moves the specified point’s Bezier handles by a certain amount. 

Arguments 

whichPath, contourindex, ptToModify , del taControl Poi ntPi rst , 
del taControl Poi nttast 

• wh i chPa th is a zero-based integer that specifies an index into the list of selected items, 
indicating which item contains the Bezier handles to move. 

• contourindex is a zero-based integer that specifies the contour that contains the handles to 
move. For paths with multiple contours, the contours are in an arbitrary order. 

• ptToModi fy is a zero-based integer that specifies the point whose handles are moved. 

• del taControl Poi ntPi rst and del taControl Poi nttast are points that specify the x,y 
coordinate values by which the preceding control point and the following control point of 
ptToModify are moved. For example, passing ({x:l,y:2}) specifies a location that is right by one 
pixel and down by two pixels. 

Returns 

Nothing. 

dom.moveElementMaskByO 

Availability 

Fireworks 4 

Description 

For all the elements in the selection that have element masks (linked or unlinked), it moves the 

element masks by the specified amount. Elements without element masks are ignored. If no 

elements in the selection have element masks, an exception is thrown. 
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Arguments 

de 1 ta 

del ta is 3. point that specifies the x,y coordinate values by which the element masks are moved 
(see “Point” on page 6). For example, passing ({x:l,y:2}) specifies a location that is right by one 
pixel and down by two pixels. 

Returns 

Nothing. 

dom.moveFNIVectorHandleByO 

Availability 

Fireworks 3 

Description 

If the selection has a fill that uses a fill vector (for example, a gradient fill), this function adjusts 
the handles of the fill vector. If the selection does not, this function has no effect. 

Arguments 

delta, whIchHandle, bConstraIn, bMoveJustOne 

• del ta is 3 point that specifies the x,y coordinate values by which the handle is moved (see 
“Point” on page 6). For example, passing ( { x:l,y:2 ) ) specifies a location that is right by one 
pixel and down by two pixels. 

• whi chHandl e specifies which handle to move and can be one of the following values: "start", 
"endl", "end2", "rotatel", or "rotate2". (Some fills ignore "end2".) Use "rotatel" or 
"rotate2" to rotate the endl or end2 point around the start point. 

• If bConstra in is true, movement is constrained to 45-degree increments. 

• If bMoveJustOne is true, only the specified handle moves. If it is fal se, other handles might 
move in sync when the specified handle is moved. 

Returns 

Nothing. 

dom.moveMaskGroupContentsByO 

Availability 

Fireworks 3 

Description 

If the selection is a mask group, this function moves the contents within the mask group by the 
specified amount. If the selected element has an element mask, this function moves the element 
(not the element mask) by the specified amount. 

Arguments 

de 1 ta 

del ta is 3 point that specifies the x,y coordinate values by which the element is moved (see 
“Point” on page 6). For example, passing ({x:l,y:2}) specifies a location that is right by one pixel 
and down by two pixels. 
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Returns 

Nothing. 

Related functions 

dom.moveEl ementMaskBy ( ) 

dom.movePixelMaskByO 

Availability 

Fireworks 4 

Description 

Moves a bitmap mode selection by the specified amount, without moving the pixels that are within 
the selection. 

Arguments 

de 1 ta 

de / ta is a point that specifies the x,y coordinate values by which the bitmap mode selection is 
moved (see “Point” on page 6). For example, passing ({x:l,y:2}) specifies a location that is right by 
one pixel and down by two pixels. 

Returns 

Nothing. 

dom.movePointOnHotspotByO 

Availability 

Fireworks 3 

Description 

If the selection is a hotspot or slice of the polyline variety, this function moves a point on the 
hotspot’s path by the specified amount. 

Arguments 

ptToModifyIndex, delta 

• ptToModi fylndex is a zero-based integer that specifies which point on the path is to move. 

• del ta IS n point that specifies the x,y coordinate values by which the point is moved (see “Point” 
on page 6). For example, passing ( { x:l,y:2 I ) specifies a location that is right by one pixel and 
down by two pixels. 

Returns 

Nothing. 
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dom.movePointOnHotspotByWithFlagsO 



Availability 

Fireworks MX 

Description 

If the selection is a hotspot or slice of the polyline variety, this function moves a point on the 
hotspot’s path by the specified amount. 

Arguments 

ptToModl fy Index, delta, flags 

ptToModi fy Index is a zero-based integer that specifies which point on the path is to move. 

del ta is 3. point that specifies the x,y coordinate values by which the point is moved (see “Point” 
on page 6). For example, passing ( { x:l,y:2 ) ) specifies a location that is right by one pixel and 
down by two pixels. 

flags is a Boolean value that determines whether this slice or hotspot will be duplicated. This 
argument is important for giving slices a unique name so their behaviors remain unaffected. 

Returns 

Nothing. 

dom.moveSelectedBezierPointsByO 

Availability 

Fireworks 3 

Description 

If the selection contains at least one path with at least one Bezier point selected, this function 
moves all selected Bezier points on all selected paths by the specified amount. 

Arguments 

de 1 ta 

del ta is 3 point that specifies the x,y coordinate values by which the selected Bezier points are 
moved (see “Point” on page 6). For example, passing ( { x:l,y:2 ) ) specifies a location that is right 
by one pixel and down by two pixels. 

Returns 

Nothing. 

dom.moveSelectionByO 

Availability 

Fireworks 3 

Description 

Moves the selected items by the specified amount or makes a copy of them and offsets them from 
the original by the specified amount. 
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Arguments 

delta, bMakeCopy , doSubSel 

• del ta is 3. point that specifies the x,y coordinate values by which the selection moved (see 
“Point” on page 6). For example, passing ( { x:l,y:2 ) ) specifies a location right by one pixel and 
down by two. 

• bMakeCopy are the items that are copied instead of moved. 

• If doSubSe 1 is set to true the function moves only the subselected parts of a path. If the 
argument is set to f al se, the function moves the whole object. 

Returns 

Nothing. 

Example 

The following command moves the selected items right by 62 pixels and down by 84 pixels, 
fw . getDocumentDOM( ) . moveSel ecti onBy ( { X : 62 , y:84), false, false): 

dom.moveSelectionMaskByO 

Availability 

Fireworks 4 

Description 

Moves the current pixel mask by the specified amount. If there is no pixel selection, an exception 
is thrown. 

Arguments 

de 1 ta 

del ta is 3 point that specifies the x,y coordinate values by which the mask is moved (see “Point” 
on page 6). For example, passing ( { x:l,y:2 ) ) specifies a location that is right by one pixel and 
down by two pixels. 

Returns 

Nothing. 

dom.moveSelectionT o() 

Availability 

Fireworks 3 

Description 

Moves or copies the selection to the specified location. 

Arguments 

location, bMakeCopy , doSubSel 

• location is 3 point that specifies the x,y coordinate values of the location to which the 
selection is moved or copied (see “Point” on page 6). 

• bMakeCopy specifies copying instead of moving the selection. 

• doSubSe 1 is set to true the function moves only the subselected parts of a path. If the 
argument is set to f al se, the function moves the whole object. 
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Returns 

Nothing. 

Example 

The following command copies only the selected parts of a path to the specified coordinates: 
fw.getDocumentDOM( ) .moveSel ectionTo( {x: 163, y:0), true, true); 

dom.moveSelectionT oFrame() 

Availability 

Fireworks 3 

Description 

Moves or copies the selection to the specified frame. 

Arguments 

framelndex, bMakeCopy 

• framelndex is a zero-based integer that specifies the frame to which the selection is moved or 
copied. To specify the current frame, pass - 1 . 

• If bMakeCopy is true, the selection is copied instead of moved. 

Returns 

Nothing. 

dom.moveSelectionT oLayer() 

Availability 

Fireworks 3, enhanced in 4 

Description 

Moves or copies the selection to the specified layer. 

Arguments 

layerindex, bMakeCopy, {whatlfMul ti pi eSel ected} , [elenientlndex] 

• 1 ayer Index is a zero-based integer that specifies the layer to which the selection should be 
moved or copied. To specify the current layer, pass -1. 

• If bMakeCopy is true, the selection is copied instead of moved. 

• whatlfMul ti p] eSel ected is an optional string that is used only if the destination is a web 
layer and bMakeCopy is true. It specifies how to create hotspots if multiple items are selected. 
Acceptable values for what If Mu 1 ti pi eSel ected are "single" (creates a single hotspot that 
has the same bounding rectangle as the selection), "mul ti pi e" (creates one hotspot for each 
item), and "ask user" (displays a dialog box to let the user decide). If 

whatlfMul ti pi eSel ected is omitted or nul 1, "ask user" is assumed. 

• e 1 ementindex, which was added in Fireworks 4, is a zero-based index that specifies the 
element before which the moved or copied selection should be inserted. If e 1 ementindex is 
omitted, the selection is placed at the top of the layer (before any other elements). Otherwise, 
it is an index within the existing elements in the layer, where 0 is the topmost, and (n - 1) 

is the last element (for a layer with n elements). The maximum value is the number of 
elements previously in the layer — meaning that the elements are moved to the bottom of 
the specified layer. 
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Returns 

Nothing. 

dom.moveSelectionT oNewLayer() 

Availability 

Fireworks 3 

Description 

Makes a new layer with a default name, then moves or copies the selection to that new layer. 

Arguments 

bMakeCopy 

If bMakeCopy is true, the selected items are copied instead of moved. 

Returns 

Nothing. 

dom.pathCropO 

Availability 

Fireworks 3 

Description 

Performs a Crop operation on the selected paths. 

Arguments 

None. 

Returns 

Nothing. 

dom.pathExpandO 

Availability 

Fireworks 3 

Description 

Performs an Expand operation on the selected paths. 

Arguments 

width, miter, cap, join 

• width is a float value that specifies the new width of the selected paths, in pixels. 

• mi ter is 3. float value that specifies the new miter angle of the selected paths, in pixels. This 
argument is ignored if join is not "miter". 

• Acceptable values for cap are "butt", "square", and "round". 

• Acceptable values for J07 17 are "bevel", "round", and "miter". 

Returns 

Nothing. 
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dom.pathInsetO 

Availability 

Fireworks 3 

Description 

Performs an Inset operation on the selected paths. 

Arguments 

width, miter. Join 

• width is a float value that specifies the new width of the selected paths, in pixels. 

• ml ter is 3. float value that specifies the new miter angle of the selected paths, in pixels. This 
argument is ignored if join is not "miter". 

• Acceptable values for join are "bevel ", "round", and "miter". 

Returns 

Nothing. 

dom.pathIntersectO 

Availability 

Fireworks 3 

Description 

Performs an Intersect operation on the selected paths. 

Arguments 

None. 

Returns 

Nothing. 

dom.pathPunchO 

Availability 

Fireworks 3 

Description 

Performs a Punch operation on the selected paths. 

Arguments 

None. 

Returns 

Nothing. 
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dom.pathSimplifyO 

Availability 

Fireworks 3 

Description 

Performs a Simplify operation on the selected paths. 

Arguments 

limit 

1 1 ml t IS n float value that specifies how much to simplify. This value corresponds to the value in 
the Modify > Alter Path > Simplify dialog box. 

Returns 

Nothing. 

dom.pathUnionO 

Availability 

Fireworks 3 

Description 

Performs a Union operation on the selected paths. 

Arguments 

None. 

Returns 

Nothing. 

dom.previewInBrowserO 

Availability 

Fireworks MX 

Description 

Previews the document in the primary or secondary browser. 

Arguments 

prImaryBrowser 

pri ma ryBrowser is a Boolean value that specifies which browser, primary (true), or secondary 
(false), should be launched by Fireworks. 

Returns 

Nothing. 
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dom.rebuildColorTableO 

Availability 

Fireworks 3 

Description 

Rebuilds the color table for the current export settings of the document. This is the same behavior 
as choosing Rebuild Color Table from the Color Table panel. 

Arguments 

None. 

Returns 

Nothing. 

dom.redoO 

Availability 

Fireworks 3 

Description 

Reinstates the last action that was undone in the document. 

Arguments 

None. 

Returns 

Nothing. 

dom.redrawO 

Availability 

Fireworks MX 

Description 

Forces the document to redraw itself immediately. This function is useful for providing feedback 
during complicated commands. 

Arguments 

None. 

Returns 

Nothing. 

dom.reflectSelectionO 

Availability 

Fireworks 3 

Description 

Reflects the selection vertically, horizontally, or both. 
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Arguments 

bHoriz, bVert, opts 

• If bHoriz is true, the items reflect horizontally. 

• Ifhl/ertistrue, the items reflect vertically. 

• Acceptable values for opts are ''transforniAttri butes "autoTrimImages", and 
"autoTrimImages transforniAttri butes". 

Returns 

Nothing. 

dom.removeAllGuidesO 

Availability 

Fireworks 3 

Description 

Removes all guides of the specified type. 

Arguments 

gui dekind 

Acceptable values for guidekind are "hori zontal " and "verti cal ". 

Returns 

Nothing. 

dom.removeBehaviorO 

Availability 

Fireworks 3 

Description 

Removes one or all behavior events from the selected hotspots and slices. 

Arguments 

leventi, {eventindexi 

• event and eventindex are optional; if they are omitted, this function removes all events from 
selected hotspots and slices. 

• event specifies the event that triggers the behavior. This argument is ignored by Fireworks. 

• eventindex is a zero-based integer that specifies the location of the behavior to be removed. To 
specify the end location, pass - 1 here. 

Returns 

Nothing. 

Related Functions dom. addBehavi or( ) 
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dom.removeBrushO 

Availability 

Fireworks 3 

Description 

Sets the brush of the selection to None. 

Arguments 

None. 

Returns 

Nothing. 

dom.removeCharacterMarkupO 

Availability 

Fireworks 3 

Description 

Reapplies the default value for the specified markup type to the text in the selection. 

Arguments 

tag 

Acceptable values for tag are " b " , " i " , and " u " , for bold, italic, and underline. 

Returns 

Nothing. 

dom.removeElementMaskO 

Availability 

Fireworks 4 

Description 

Removes the mask from the selected element. Only one element can be selected when calling this 
function. If selecting more than one element (or none) at the time this function is called, 
Fireworks throws an exception. 

Arguments 

whatif El ementlsAn Image 

• whatif El ementlsAn Image is used only if the element (not the element mask) is an image. 
Acceptable values for what If El ementlsAn Image are "apply" (apply the element mask to the 
image before discarding the element mask) , "discard" (discard the element mask) , and "ask" 
(displays a dialog box to let the user decide). 

• If you pass "ask" and the user cancels the dialog box. Fireworks returns an error. 

Returns 

Nothing. 
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dom.removeFontMarkupO 

Availability 

Fireworks 3 

Description 

Reapplies the default value for the specified font attribute to the text in the selection. 

Arguments 

fontAttrl bute 

Acceptable values for fontAttrl bute are "size", "color", and "face". 

Returns 

Nothing. 

dom.removeFillO 

Availability 

Fireworks 3 

Description 

Sets the fill of the selection to None. 

Arguments 

None. 

Returns 

Nothing. 

dom.removeGuideO 

Availability 

Fireworks 3 

Description 

Removes the specified guide. If no guide is at that position, this function has no effect. 

Arguments 

position, gul dekind 

• pos 1 1 1 on is a float value that specifies the position of the guide to be removed. 

• Acceptable values for go 7 de/c 7 nd are "horizontal" and "verti cal ". If gu/de/c/nd is 
"horizontal ", it is assumed that posi t Ion is ay coordinate; if gul dekind is "vert i cal ", it 
is assumed that pos 1 1 1 on is an x coordinate. 

Returns 

Nothing. 
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dom.removeT ransformation() 

Availability 

Fireworks 3 

Description 

Removes the transformations, if any, from the selected text or instances. 

Arguments 

None. 

Returns 

Nothing. 

dom.reorderFrameO 

Availability 

Fireworks 3 

Description 

Moves or copies the specified frame before another specified frame. 

Arguments 

frameToMove, frameToPutltBefore, bMakeCopy 

• frameToMove is a zero-based integer that specifies which frame to move or copy. 

• frameToPutltBefore is a zero-based integer that specifies which frame you want to move or 
copy the frame before. That is, if you pass 1 for frameToMove And 0 for frameToPutltBefore, 
the second frame is placed before the first frame. 

• If bMakeCopy is true, the specified frame is copied instead of moved. 

Returns 

Nothing. 

Example 

The following command moves the third frame before the first frame, 
fw . getDocumentDOM( ) . reorderFrame( 2 , 0, false); 

d o m . reo rd e rLay e r() 

Availability 

Fireworks 3 

Description 

Moves or copies the specified layer before another specified layer. 

Arguments 

1 ayerToMove . layerToPutltBefore, bMakeCopy 

• 1 ayerToMove is a zero-based integer that specifies which layer to move or copy. 

• 1 ayerToPut ItBefore is a zero-based integer that specifies which layer to move or copy the 
layer before. That is, if you pass 1 for 1 ayerToMove and 0 for layerToPutltBefore, the 
second layer is placed before the first layer. 
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• If bMa keCopy is true, the specified layer is copied instead of moved. 

Returns 

Nothing. 

dom.replaceButtonTextStringsO 

Availability 

Fireworks 3 

Description 

Replaces all text items (selected and unselected) within the document that are defined as Button 
Text items with the specified string. (Button Text items are defined as the topmost text items on 
each frame.) 

Arguments 

newStrIng, un1 formAttrs 

• newStri ng specifies the string to be used as replacement text. 

• If uni formAttrs is f al se, each character retains the attributes of the character that was 
formerly in its position; that is, Fireworks preserves the existing formatting. If uni formAttrs is 
true, all characters assume the attributes of the first character in the string that is being 
replaced. 

Returns 

Nothing. 

Related functions 

dom . repl aceButtonTextStri ngslnlnstancesl) 

dom.replaceButtonTextStringsInInstancesO 

Availability 

Fireworks 3 

Description 

Replaces selected button text items with the specified string. (Button text items are defined as the 
topmost text items on each frame.) 

Arguments 

newString, uni formAttrs 

• newString specifies the string to be used as replacement text. 

• If uni formAttrs is f al se, each character retains the attributes of the character that was 
formerly in its position; that is. Fireworks preserves the existing formatting. If uni formAttrs is 
true, all characters assume the attributes of the first character in the string that is being 
replaced. 

Returns 

Nothing. 

Related functions 

dom . repl aceButtonTextStri ngs ( ) 
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dom.replaceTextStringO 

Availability 

Fireworks 3 

Description 

Replaces the text of all selected text items with the specified string. 

Arguments 

newStrIng, uniforniAttrs 

• newStri ng specifies the string to be used as replacement text. 

• If uni formAttrs is f al se, each character retains the attributes of the character that was 
formerly in its position; that is, Fireworks preserves the existing formatting. If uni fo rmA tins is 
true, all characters assume the attributes of the first character in the string that is being 
replaced. 

Returns 

Nothing. 

dom.resizeSelectionO 

Availability 

Fireworks 3 

Description 

Resizes the selection to the specified pixel width and height, keeping the top-left corner of the 
selection in place. 

Arguments 

width, height 

width and height are integers that specify the new width and height in pixels. 

Returns 

Nothing. 

dom. restore JPEGMaskO 

Availability 

Fireworks 4 

Description 

Restores the selection that is specified in dom. saveJPEGMask( ) (see “dom.saveJPEGMaskO” on 
page 122). 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom.saveJPEGMask( ) 
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dom.restoreSelectionO 



Availability 

Fireworks 4 

Description 

Restores the selection that is specified in dom. saveSel ecti on ( ) (see “dom.saveSelectionO” on 
page 122). 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom . saveSel ecti on ( ) 

dom.reversePathT extDirection() 

Availability 

Fireworks 3 

Description 

For all text-on-a-path items in the selection, it reverses the direction of the text along the path. 

Arguments 

None. 

Returns 

Nothing. 

dom.rotateDocumentO 

Availability 

Fireworks 3 

Description 

Rotates the entire document 90, 180, or 270 degrees clockwise. Rotating 270 degrees is the same 
behavior as rotating 90 degrees counterclockwise. 

Arguments 

rotatl onAmount 

Acceptable values for rotati onAmount a.ce 90, 180, and 270. 

Returns 

Nothing. 
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dom.rotateSelectionO 

Availability 

Fireworks 3 

Description 

Rotates the selection clockwise by the specified number of degrees. Rotating 270 degrees is the 
same behavior as rotating 90 degrees counterclockwise. 

Arguments 

rotatl onDegrees . opts 

• rotati onDegrees is a float value that specifies the number of degrees to rotate the selection. 

• Acceptable values for opts are " transf ormAttri butes", ''autoTrimlmages'', and 
"autoTrimImages transf ormAttri butes". 

Returns 

Nothing. 

dom.saveO 

Availability 

Fireworks 3 

Description 

Saves the document in its default location. After a successful Save operation, the document’s 
i sDi rty property clears. 

Arguments 

{ bOkToSaveAs] 

If bOkToSaveAs is true or omitted and the file was never saved, then the Save As dialog box 
appears. If bOkToSaveAs is false and the file was never saved, the file is not saved. 

Returns 

true if the Save operation completes successfully; false otherwise. 

dom.saveCopyAsO 

Availability 

Fireworks 3 

Description 

Saves a copy of the document in a specified directory with a specified name. This function does 
not affect the document’s f i 1 ePathForSave or i sDi rty properties. 

Arguments 

fileURL 

fi 1 eilRL is a string, which is expressed as a file://URL, that specifies the directory and name 
under which the copy should be saved. 

Returns 

true if the Save operation completes successfully; false otherwise. 
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dom.saveJPEGMaskO 

Availability 

Fireworks 4 

Description 

Stores the current selection in bitmap mode as the “Selective JPEG mask”. Use 

dom. restoreJPEGMask( ) to restore the mask (see “dom.restoreJPEGMaskQ” on page 119). 

Arguments 

None. 

Returns 

Nothing. 

Related Functions 

dom.restoreJPEGMask() 

dom.saveSelectionO 

Availability 

Fireworks 4 

Description 

Stores the current selection in bitmap mode as the saved selection. Use 

dom . restoreSel ecti on ( ) to restore the selection (“dom.restoreSelectionO” on page 120). 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom.restoreSelection() 

dom.scaleSelectionO 

Availability 

Fireworks 3 

Description 

Scales the selection in the horizontal and vertical axes. 

Arguments 

xScal eAmount , yScal eAmount , opts 

• xSca 1 eAmount and ySca 1 eAmount are float values that specify the amount to scale the 
selection in the horizontal and vertical axes. Acceptable values are 0.0 or greater; a value of 1 
represents 100 percent, 2 represents 200 percent, and so on. 

• Acceptable values for opts are " t ransf ormAttri butes", ''autoTrimlmages'', and 
"autoTrimImages t ransf ormAttri butes". 
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Returns 

Nothing. 

Example 

The following command scales the selected items to approximately two-thirds (67 percent) and 
automatically trims the images and transforms the attributes. 

fw . getDocumentDOM( ).scaleSelection(0.67, 0.67, "autoTri ml mages 
transformAttri butes " ) ; 

dom.selectAdjustPixelSelO 

Availability 

Fireworks 3 

Description 

Expands or reduces the pixel selection by the specified number of pixels, selects a border of pixels, 
or smooths the edge of the pixel selection. 

Arguments 

whatToDo, amount 

Acceptable values for whatToDo are "expand", "contract", "border", and "smooth". Any 
integer is acceptable for amount. 

• Use "expand" to expand the pixel selection outward by the number of pixels that are specified 
by amount. 

• Use "contract" to reduce the pixel selection inward by the number of pixels that are specified 
by amount. 

• Use "border" to select a band of pixels the width of amount around the edge of the pixel 
selection. 

• Use "smooth " to smooth out the edge of the pixel selection by amount. 

Returns 

Nothing. 

dom.selectAIIO 

Availability 

Fireworks 3 

Description 

Selects all the items in the current layer and frame. If single layer editing is enabled, all the items 
in the current layer are selected; otherwise, all elements on all layers are selected. 

Arguments 

None. 

Returns 

Nothing. 
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dom.selectAIIOnLayerO 

Availability 

Fireworks MX 

Description 

Selects all the items on the given layer in the current frame. This function deselects objects on 
other layers. If the only element on the layer is a bitmap, Fireworks will enter paint mode on the 
bitmap. 

Arguments 

1 ayer Index 

1 ayer Index is a long integer that identifies the layer on which to select the element. 

Returns 

Nothing. 

dom.selectChildrenO 

Availability 

Fireworks 3 

Description 

Selects the children, if any, of the selection. For example, if a group is selected, the selection 
changes from the group to the individual members of the group. 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom . sel ectParents ( ) 

dom.selectFeatherO 

Availability 

Fireworks 3 

Description 

If Fireworks is in bitmap mode and a pixel selection is active, this function feathers the selection 
by the specified number of pixels. 

Arguments 

featherAmount 

feather Amount is an integer that specifies the number of pixels by which to feather the selection. 

Returns 

Nothing. 
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dom.selectInverseO 

Availability 

Fireworks 3 

Description 

If Fireworks is in bitmap mode and a pixel selection is active, this function inverts the pixel 
selection. 

Arguments 

None. 

Returns 

Nothing. 

dom.selectNoneO 

Availability 

Fireworks 3 

Description 

Deselects any selected items. If Fireworks is in image edit mode, has a pixel selection, and has a 
Selection tool selected, then this function deselects the pixels and exits image edit mode. 

Arguments 

None. 

Returns 

Nothing. 

dom.selectParentsO 

Availability 

Fireworks 3 

Description 

Selects the parents, if any, of the selection. That is, if all the members of a group are selected, the 
individual members are deselected, and the group is selected. 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom.selectChildren() 
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dom.selectSimilarO 

Availability 

Fireworks 3 

Description 

If Fireworks is in bitmap mode and a pixel selection is active, this function selects all pixels in the 
current image that are within the specified tolerance of the average color in the current pixel 
selection. 

Arguments 

tolerance, edgeniode, featherAmt, combi neniode 

• tolerance is an integer between 0 and 255, inclusive, that specifies the tolerance for selecting 
pixels. 

• Acceptable values for edgemode are " hard edge", "anti al i as and "feather". 

• featherAmt is an integer that specifies the number of pixels to feather. This value is ignored if 
edgemode is not "feather". 

• combinemode specifies how to combine the new selection mask with the existing mask. 
Acceptable values are " repl ace", "add", "subtract", and "i ntersect". 

Returns 

Nothing. 

Related functions 

dom. selects imilarfromPointi) 

dom.selectSimilarFromPointO 

Availability 

Fireworks 3 

Description 

Behavior is almost identical to dom. sel ectSi mi 1 ar( ), except that the new mask is calculated 
from the color at the specified location in the image, rather than from the average color in the 
selection. 

Arguments 

where, tolerance, edgemode, featherAmt , combinemode 

• where is a point that specifies the x,y coordinates of the pixel whose color is used to calculate 
the new mask (see “Point” on page 6). 

• tolerance is an integer between 0 and 255, inclusive, that specifies the tolerance for selecting 
pixels. 

• Acceptable values for edgemode are "hard edge", "anti al i as ", and "feather". 

• featherAmt is an integer that specifies the number of pixels to feather. This value is ignored if 
edgemode is not "feather". 

• combinemode specifies how to combine the new selection mask with the existing mask. 
Acceptable values are " repl ace", "add", "subtract", and "i ntersect". 
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Returns 

Nothing. 

Related functions 

dom . sel ectSi mi 1 ar( ) 

dom.setAIILayersDisclosureO 

Availability 

Fireworks 4 

Description 

Specifies whether all the elements in all layers appear in the Layers list. 

Arguments 

bD1 scl osed 

If bOi scl osed is true, all the elements on all layers appear in the Layers list. If f a 1 se, only layer 
names appear on the list. 

Returns 

Nothing. 

Related functions 

“dom . setLayerDi scl osure( ) ” on page 147 

dom.setAnimlnstanceLoopCountO 

Availability 

Fireworks 3, deprecated in 4 in favor of “dom.setAnimlnstanceNumFramesO” on page 127 

Description 

Sets the loop count of the selected instances of multiframe image symbols. 

Arguments 

1 oopCount 

1 oopCount is an integer that corresponds to the loop count value that appears in the Objects 
panel when a multiframe image instance is selected. 

Returns 

Nothing. 

dom.setAnimlnstanceNumFramesO 

Availability 

Fireworks 4 

Description 

Sets the number of frames to animate the currently selected animation element. 

Arguments 

numFrames 

numFrames is an integer that specifies the number of frames through which the symbol animates. 
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Returns 

Nothing. 

Related functions 

dom.convertToAnimSymbol ( ) 

dom.setAnimlnstanceOffsetDistO 

Availability 

Fireworks 4 

Description 

Sets the distance, in pixels, to animate the currently selected animation element. 

Arguments 

offsetDIstPt 

offsetDistPt is a point that specifies the distance the animation moves in pixels. For example, 
passing ({x:100, y:25}) animates the symbol to the right by 100 pixels and down by 25 pixels. 

Returns 

Nothing. 

Related functions 

dom.convertToAnimSymbol ( ) 

dom.setAnimlnstanceRotationAmountO 

Availability 

Fireworks 4 

Description 

Sets the rotation amount, in degrees, to animate the currently selected animation element. 

Arguments 

rotatl onAmount 

rotati onAmount is a fioat value that specifies the degree of rotation to be applied to the 
animation symbol. For example, passing 720 specifies an animation that does two complete 
clockwise rotations. To rotate the animation counter-clockwise, pass a negative number. 

Returns 

Nothing. 

Related functions 

dom.convertToAnimSymbol ( ) 

dom.setAnimlnstanceScaleAmountO 

Availability 

Fireworks 4 

Description 

Sets the scale amount to animate the currently selected animation instance. 
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Arguments 

sea 1 eAmount 

sea 1 eAmount is a positive float value that specifies the amount of scaling to be applied to the 
animation symbol. For example, passing 50 scales the symbol to 50 percent of its current size, and 
passing 200 scales it to twice its current size. To specify no scaling, pass 100. 

Returns 

Nothing. 

Related functions 

dom.convertToAnimSymbol ( ) 

dom.setAnimlnstanceStartEndOpacityO 

Availability 

Fireworks 4 

Description 

Sets the starting and ending opacity of the currently selected animation symbol. 

Arguments 

startOpaelty . endOpaelty 

startOpaei ty and endOpaei ty are float values between 0 and 100 that specify the starting and 
ending opacity for the animation symbol. 

Returns 

Nothing. 

Related functions 

dom.convertToAnimSymbol ( ) 

dom.setAnimlnstanceStartFrameO 

Availability 

Fireworks 3, deprecated in 4 in favor of placing the animation symbol on the frame in which it 
should start. 

Description 

Sets the start frame of the selected instances of multiframe image symbols. 

Arguments 

startFrame 

startFrame is an integer that corresponds to the starting frame value that appears in the Objects 
panel when a multiframe image instance is selected. 

Returns 

Nothing. 
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dom.setBlendModeO 

Availability 

Fireworks 3 

Description 

Specifies the blend mode of the selection. 

Arguments 

mode 

Acceptable values for mode are "normal ", "multiply", "screen ", "darken ", "lighten", 
"di fference", "hue", "saturation", "color", "1 umi nosi ty ", "invert", "tint", and 
"erase". 

Returns 

Nothing. 

dom.setBrushO 

Availability 

Fireworks 3 

Description 

Sets the selection to the specified brush. 

Arguments 

brush 

brush is a Brush object (see “Brush” on page 21). 

Returns 

Nothing. 

Related functions 

dom.setBrushColori), dom.setBrushNamei). dom.setBrushNCol orNTexturei ) , 
dom.setBrushPl a cement! ) 

dom.setBrushColorO 

Availability 

Fireworks 3 

Description 

Sets the brush color of the selection to the specified color. 

Arguments 

color 

col or is a color string (see “Color string” on page 5). 

Returns 

Nothing. 

Related functions 

dom.setBrushNCol orNTexture! ) 
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dom.setBrushNameO 

Availability 

Fireworks 3 

Description 

Renames a brush. Does not change the brush category. 

Arguments 

category, currentName . newName 

• category is a string that specifies the category of the brush to be renamed. 

• currentName is a string that specifies the current name of the brush. 

• newName is a string that specifies the new name of the brush. 

Returns 

Nothing. 

dom.setBrushNColorNT exture() 

Availability 

Fireworks 3 

Description 

Sets the selection to the specified brush, brush color, and brush texture. 

Arguments 

brush, color, texture-name 

• brush is a Brush object (see “Brush” on page 21). 

• color is a. color string (see “Color string” on page 5). 

• texture-name is the name of the texture to be applied. 

Returns 

Nothing. 

Related functions 

dom . setBrushCol or( ) 

dom.setBrushPlacementO 

Availability 

Fireworks 3 

Description 

Specifies the brush placement of the stroke on the selection. 

Arguments 

placement 

Acceptable values for pi acement are "inside", "center", and "outside". 

Returns 

Nothing. 
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dom.setButtonAutoSliceO 

Availability 

Fireworks 3 

Description 

If the user is editing a Button document, this function turns automatic slicing on or off 

Arguments 

bAutoSl 1ce 

If bAutoSl i ce is true, automatic slicing is turned on. If bAutoSl i ce is false, it is turned off 

Returns 

Nothing. 

dom.setButtonIncludeDownStateO 

Availability 

Fireworks 3 

Description 

If the user edits a Button document, this function specifies whether to include the “down” state in 
a button. 

Arguments 

bind udeDownState 

If bind udeDownState is true, the “down” state is included in the button. If 
bind udeDownState is fal se, it is not. 

Returns 

Nothing. 

dom.setButtonIncludeOverWhileDownStateO 

Availability 

Fireworks 3 

Description 

If the user edits a Button document, this function specifies whether to include the “over-while- 
down” state in a button. 

Arguments 

bind udeOverUhi 1 eDownState 

If bind udeOverUhl 1 eDownState is true, the “over-while-down” state is included in the button. 
If bind udeOverUhi ] eDownState is fal se, it is not. 

Returns 

Nothing. 
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dom.setButtonShowDownOnLoadO 

Availability 

Fireworks 3 

Description 

If the user edits a Button document, this function specifies whether to show the “down-state-on- 
load” in a button. 

Arguments 

bShowDownOnLoad 

If bShowDownOnLoad is true, the down-state-on-load is shown in the button. If 
bShowDownOnLoad is fal se, it is not. 

Returns 

Nothing. 

dom.setButtonOptionsO 

Availability 

Fireworks 3 

Description 

Sets the Button Export options. If the user edits a button, it sets options for the button being 
edited; if the user edits a normal document, it sets options for all the selected buttons. 

Arguments 

exportOptI ons , URLStrIng, al tTagString , targetTagString , sHceName, 
statusMessage 

• exportOptI ons is an ExportOpti ons object (see “ExportOptions” on page 33). 

• URLString is a string that specifies the URL for the button(s). 

• a 1 tTagString and targetTagString specify the text for the button alt tag and target tag. 

• si i ceName is a string that specifies the name to be assigned to the slice that is associated with 
the button. If it is null, the slice is set to be named automatically. 

• statusMessage is a string that specifies a status message to appear in the browser status line. If 
an empty string or nul 1 is passed, no status message appears. 

Returns 

Nothing. 
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dom.setDefaultBrushAndFillColorsO 

Availability 

Fireworks 3 

Description 

Resets the document’s brush and fill color to the default. 

Arguments 

None. 

Returns 

Nothing. 

dom.setDefaultFNIVectorO 

Availability 

Fireworks 3 

Description 

Sets the fill-vector on the selection to the default. 

Arguments 

None. 

Returns 

Nothing. 

dom.setDocumentCanvasColorO 

Availability 

Fireworks 3 

Description 

Sets the canvas color of the document to the specified color. 

Arguments 

color 

col or is a color string (see “Color string” on page 5). 

Returns 

Nothing. 

Example 

The following command sets the canvas color to blue. 

fw. get Document DOM ( ) . setDocumentCanvasCol or( ''#0000ff ; 
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dom.setDocumentCanvasSizeO 

Availability 

Fireworks 3 

Description 

Sets the document’s canvas size to the specified rectangle. 

Arguments 

boundl ngRectangl e 

boundi ngRectangl e is a rectangle that specifies the new canvas size for the document, in pixels 
(see “Rectangle” on page 6). Any items outside the specified rectangle are removed. 

Returns 

Nothing. 

Example 

The following command sets the canvas to a size of 200 by 200 pixels. 

fw . getDocumentDOM( ).setDocumentCanvasSize({left:150, top:150, right:350, 
bottom : 350 ) ) ; 

dom.setDocumentCanvasSizeToDocumentExtentsO 

Availability 

Fireworks 3 

Description 

Calculates the size of all the items in the document and resizes the document canvas to that size. 
This action is the same behavior as Modify > Trim Canvas. 

Arguments 

bGrowCanvas 

If bGrowCanvas is true, the canvas can expand or shrink in size. If bGrowCanvas is f al se, it 
only shrinks. 

Returns 

Nothing. 

Example 

The following command resizes the canvas to include all the items in the document, enlarging the 
canvas if necessary. 

fw . getDocumentD0M( ).setDocumentCanvasSi zeToDocument Extents (true) ; 

Related functions 

dom . set Document Canvas Si zeToSel ecti on ( ) 
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dom.setDocumentCanvasSizeToSelectionO 

Availability 

Fireworks 3 

Description 

Calculates the size of all the items in the selection and resizes the document canvas to that size. 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom . set Document Canvas Si zeToDocument Extents ( ) 

dom.setDocumentImageSizeO 

Availability 

Fireworks 3 

Description 

Scales the document to fit in the specified rectangle at the specified resolution. 

Arguments 

boundl ngRectangl e , resolution 

• boundi ngRectangl e is a rectangle that specifies the size to which the document should be 
scaled (see “Rectangle” on page 6). 

• resol uti on specifies the resolution for the scaled document (see “Resolution” on page 6). 

Returns 

Nothing. 



dom.setDocumentResolutionO 

Availability 

Fireworks 3 

Description 

Sets the resolution of the document. 

Arguments 

resolution 

resol uti on specifies the resolution for the document (see “Resolution” on page 6). 

Returns 

Nothing. 
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dom.setEffectNameO 

Availability 

Fireworks MX 

Description 

Sets the name for the current effect. 

Arguments 

category, oldName, newName 

• category is a string that defines the name of the category of the effect. 

• 0 1 dName is the existing name of the effect. 

• newName is the new name to give to the effect. 

Returns 

Nothing. 

dom.setElementMaskModeO 

Availability 

Fireworks 4 

Description 

Sets the rendering mode on the selected element’s element mask. Only one element can be 
selected when calling this function. If selecting more than one element (or none) at the time this 
function is called, Fireworks throws an exception. Fireworks also returns an error if the selected 
element has no element mask. 

Arguments 

mode 

Acceptable values for mode are "mask to image" and "mask to path". 

Returns 

Nothing. 

dom.setElementMaskShowAttrsO 

Availability 

Fireworks 4 

Description 

Specifies whether the currently selected vector mask shows the fill and stroke. 

Arguments 

bShow 

If bS how is true, the vector mask fill and stroke are visible. If f a 1 se, they are hidden. 

Returns 

Nothing. 
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dom.setElementNameO 



Availability 

Fireworks 3 

Description 

Sets the name of the selected element(s). 

Arguments 

name 

name is a string that specifies the name to be assigned to the selected element(s). To specify that 
no name should be assigned or that an existing name should be removed, pass null. 

Returns 

Nothing. 

Related functions 

dom.findNamedEl ements ( ) 

dom.setElementVisibleO 

Availability 

Fireworks 4 

Description 

Shows or hides the specified element(s). 

Arguments 

frameindex, layerindex, elementindex, bShow 

• frameindex is a zero-based integer that specifies the frame that contains the element(s) to be 
shown or hidden. To specify the current frame, pass - 1 . 

• 1 ayer Index is a zero-based integer that specifies the layer that contains the element(s) to be 
shown or hidden. To specify the current layer, pass -1. 

• e 1 ementindex is a zero-based integer that specifies the element(s) to show or hide, where 0 
represents the topmost element in the specified layer. To show or hide all the elements in the 
specified layer, pass - 1 . 

• If bShow is true, the element(s) are visible. If bShow is false, they are hidden. 

Returns 

Nothing. 

Example 

The following command hides all the elements in the current frame and layer, 
fw . getDocumentDOMl ) . setEl ementVi si bl e( - 1 , -1, -1, false) 

Related functions 

dom . setEl ementVi si bl eByNamel ) 
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dom.setElementVisibleByNameO 

Availability 

Fireworks 4 

Description 

Shows or hides all the elements with the specified name. If no element has the specified name, an 
exception is thrown. If the elements are hidden because they are on a hidden layer or frame, for 
example, this function does not show them. 

Arguments 

name, bShow 

• name is a string that specifies the name of the element(s) to be shown or hidden. If more than 
one element has the same name, this function shows or hides all of them. 

• If bShoM is true, the elements are visible. If bShow is f al se, they are hidden. 

Returns 

An array of the elements(s) for which visibility was set. 

Related functions 

dom.findNamedEl ements ( ) , dom. setEl ementName( ) , dom. setEl ementVi si bl e( ) 

dom.setExportOptionsO 

Availability 

Fireworks 3 

Description 

Sets the document Export Options. 

Arguments 

exportOptI ons 

exportOpti ons is an ExportOpti ons object (see “ExportOptions” on page 33). 

Returns 

Nothing. 

dom.setExportSettingsO 

Availability 

Fireworks 3 

Description 

Sets the document Export Settings. 

Arguments 

exportSettI ngs 

exportSettI ngs is an ExportSetti ngs object (see “ExportSettings” on page 36). 

Returns 

Nothing. 
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dom.setFillO 

Availability 

Fireworks 3 

Description 

Sets the selection to the specified fill. 

Arguments 

fill 

fill is a Fi 1 1 object (see “Fill” on page 38). 

Returns 

Nothing. 

dom.setFillColorO 

Availability 

Fireworks 3 

Description 

Changes the fill color of the selection to the specified color. 

Arguments 

color 

col or is a color string (see “Color string” on page 5). 

Returns 

Nothing. 

dom.setFillEdgeModeO 

Availability 

Fireworks 3 

Description 

Sets the edge type for selected items with fills. 

Arguments 

edgemode, featherAmt 

• Acceptable values for edgemode are "hard edge", "anti al i as ", and "feather". 

• featherAmt is a.n integer that specifies the number of pixels to feather. This value is ignored if 
edgemode is not "feather". 

Returns 

Nothing. 
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dom.setFilINColorO 

Availability 

Fireworks MX 

Description 

Sets the selection to the specified fill and fill color. 

Arguments 

fm, color 

• f? ? ? is a Fi 1 1 object (see “Fill” on page 38). 

• col or is a color string (see “Color string” on page 5). 

Returns 

Nothing. 

dom.setFilINColorNTextureO 

Availability 

Fireworks 3 

Description 

Sets the selection to the specified fill, fill color, and fill texture. 

Arguments 

fill, color, texture-name 

• f? J ? is a Fi 1 1 object (see “Fill” on page 38). 

• col or is a color string (see “Color string” on page 5). 

• texture-name is the name of the texture to be applied. 

Returns 

Nothing. 

Example 

The following command sets the selected items to a linear fill with a feather edge and no texture. 

fw . getDocumentDOM( ) . set Fi 1 1 NCol orNTexturei { category : "f c_Li near" , 

di therCol ors : [ "#000000", "#000000" ], edgeType: "antial iased" , feather:10, 
gradient:! name : "cn_Whi teBl ack" , nodes:[ { col or : "#f f f fff " , positioniO ), { 
col or : "#000000" , position:! ) ] ), name: "fn_Normal " , pattern : nul 1 , 
shape : "1 i near" , stampingMode: "bl end opaque", textureBl end : 0 , 
webDi therTransparent : f al se ), "#666666", "Grain"); 

dom.setFNIPIacementO 

Availability 

Fireworks 3 

Description 

Sets the fill placement for selected items with fills. 

Arguments 

placement 
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Acceptable values for placement are "top" and "bottom". 

Returns 

Nothing. 

dom.setFMIVectorO 

Availability 

Fireworks 3 

Description 

Sets the fill vectors of the selection to the specified absolute values. 

Arguments 

pi, p2 , p3 

pi, pZ, and p3 are points that specify the x,y coordinates of the three points to be used in calculating 
the fill vector (see “Point” on page 6). 

Returns 

Nothing. 

dom.setFillVectorStartO 

Availability 

Fireworks 3 

Description 

Modifies the fill vectors of the selection by moving the fill start to the specified point and then 
moving the two fill end handles to the same relative position. 

Arguments 

. . . 

pi is a point that specifies the x,y coordinates of the fill start and relative end handle placement to be 
used (see “Point” on page 6). 

Returns 

Nothing. 
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dom.setGradientNameO 

Availability 

Fireworks 3 

Description 

Renames a gradient. 

Arguments 

currentName . newName 

• currentName is a string that specifies the current name of the gradient. 

• newName is a string that specifies the new name of the gradient. 

Returns 

Nothing. 

dom.setGridOriginO 

Availability 

Fireworks 3 

Description 

Sets the grid origin for the document. 

Arguments 

gri dOri gi n 

gri dOri gi n is a point that specifies the x,y coordinates that are used for the documents grid 
origin (see “Point” on page 6). 

Returns 

Nothing. 

dom.setGridSizeO 

Availability 

Fireworks 3 

Description 

Sets the grid size for the document. 

Arguments 

gr1dS1 ze 

gridSize is a point that specifies the x,y coordinates that are used for the documents grid size 
(see “Point” on page 6). 

Returns 

Nothing. 
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dom.setGridColorO 

Availability 

Fireworks 3 

Description 

Sets the color used to display the grid. 

Arguments 

gridColor 

gridColor is a color string (see “Color string” on page 5). 

Returns 

Nothing. 

dom.setGroupTypeO 

Availability 

Fireworks 3, argument deprecated in 4 

Description 

Changes the group type for the currently selected groups. 

Arguments 

{ type] 

type is an optional string that specifies how to group the items. Acceptable values are "normal ", 
"mask to image", and "mask to path". If the argument is omitted, "normal " is assumed, 
("mask to image" and "mask to path" are deprecated in 4.) 

Returns 

Nothing. 

dom.setGuideColorO 

Availability 

Fireworks 3 

Description 

Sets the color that is used to display normal (nonslice) guides. To set the color of slice guides, use 
“dom.setSliceGuideColorO” on page 157. 

Arguments 

gu1 deCol or 

gui deCol or is a color string (see “Color string” on page 5). 

Returns 

Nothing. 
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dom.setHotspotAItTagO 

Availability 

Fireworks 3 

Description 

Sets the alt tag text to the specified value for the hotspots and slices in the selection. 

Arguments 

whatToSet, al tTagString 

• Acceptable values for w/iatfoSet are " hotspots ", "si i ces and " hotspots and slices". 

• al tTagString IS 2, string that specifies the text to be used for the alt tag. 

Returns 

Nothing. 

Example 

The following command sets the text attributes of the alt tag of the selected slices to "Th i s is my 
alt tag". 

fw . getDocumentDOMl ) . setHotspotAl tTag ( "si i ces " , "Thi s is my alt tag"); 

dom.setHotspotColorO 

Availability 

Fireworks 3 

Description 

Sets the color to the specified value for the hotspots and slices in the selection. 

Arguments 

whatToSet, color 

• Acceptable values for iv/iatroSet are " hotspots ", "si i ces ", and " hotspots and slices". 

• col or is a color string (see “Color string” on page 5) . 

Returns 

Nothing. 

Example 

The following command sets the color of the selected hotspots to the specified value, which, in 
this case, is red. 

fw . getDocumentDOMl ). setHotspotCol or (" hotspots " , "#f f 0000" ) ; 

dom.setHotspotRectangleO 

Availability 

Fireworks 3 

Description 

If the selection is a single hotspot or slice, this function moves or copies it to the specified location 
and size. 
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Arguments 

boundl ngRectangl e , bMakeCopy 

• boundl ngRectangl e is a rectangle that specifies the size of the new hotspot or slice (see 
“Rectangle” on page 6). 

• bMakeCopy is a Boolean value; if it is true, the selection is copied and resized instead of moved 
and resized. 

Returns 

Nothing. 

dom.setHotspotShapeO 

Availability 

Fireworks 3 

Description 

Sets the shape to the specified value for the hotspots and slices in the selection. 

Arguments 

whatToSet, shape 

• whatfoSet can be ''hotspots'', "si ices", or "hotspots and slices". 

• shape can be "rectangle", "oval ", or "polyline". 

Returns 

Nothing. 

dom.setHotspotTargetO 

Availability 

Fireworks 3 

Description 

Sets the target tag text to the specified value for the hotspots and slices in the selection. 

Arguments 

whatToSet, targetTagString 

• whatToSet can be "hotspots", "si ices", or "hotspots and slices". 

• targetTagString is a string that specifies the text to be used for the target tag. 

Returns 

Nothing. 

Example 

The following command sets the currently selected slices to link to the parent window, 
fw . getDocumentDOM( ) . setHotspotTarget ("slices", "_parent " ) ; 
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dom.setHotspotT ext() 



Availability 

Fireworks 3 

Description 

Sets the hotspot text to the specified value for the hotspots and slices in the selection. 

Arguments 

whatToSet, textstring, url ToMatch , bUpdateAttri butes 

• w/iatfoSet can be ''hotspots'', "si ices", or "hotspots and slices". 

• textstring is a string that specifies the text to be used for the hotspot or slice. 

• url ToMatch is a string that specifies a URL that is already assigned to one or more hotspots in 
the document. If this value is not null, the URLs of all hotspots or slices in the document that 
have url ToMatch as their URL are changed to textstring. Note: The URLs of both selected 
and unselected hotspots or slices are changed. 

• bUpdateAttri butes IS true, changed hotspots inherit the color, target, and alt tag text that 
were most recently associated with the new text value. For example, suppose textstring is 
"http : / /WWW .my webs i te.com", and the last time "http : //www. mywebsi te.com" was used, 
it was used with a color of blue, a target of none, and an alt tag of “Link to My Home Page”. If 
bUpdateAttri butes is true, any hotspot or slice whose text is now being changed to " http : / 
/WWW .mywebsi te.com" will also have a color of blue, a target of none, and an alt tag text of 
“Link to My Home Page”. 

Returns 

Nothing. 

Example 

The following command creates a slice and inserts the HTML text, “ I am HTML text”. 

fw . getDocumentDOM( ) . setHotspotText ( "SI i ce ","I am HTML text", null, true): 

dom.setLayerDisclosureO 

Availability 

Fireworks 4 

Description 

Specifies whether the elements on a specified layer appear in the Layers list. Disclosure affects the 

layer, regardless of which frame appears. 

Arguments 

1 ayerindex, bOi scl osed 

• 1 ayerindex is a zero-based index that specifies the layer that contains the elements to be 
displayed or hidden. To specify the current layer, pass -1. 

• If bD? sc /osed is true, all elements on the specified layer are displayed in the Layers list. If 
bOi scl osed is false, only the layer name appears on the list. 
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Returns 

Nothing. 

Related functions 

dom.setAllLayersDisclosure() 

dom.setLayerLockedO 

Availability 

Fireworks 3 

Description 

Locks or unlocks one or all the layers on the specified frame. 

Arguments 

1 ayerindex, framelndex, bLock, bAll Layers 

• 1 ayerindex is a zero-based integer that specifies the layer to be locked or unlocked. To specify 
the current layer, pass - 1. (To lock or unlock all the layers on a frame, use the bA 1 1 Layers 
argument.) 

• framelndex is a zero-based integer that specifies the frame that contains the layer that is to be 
locked or unlocked. To specify the current frame, pass -1. 

• If block is true, the layer is locked. If block is fal se, it is unlocked. 

• If bAl 1 Layers is true, all the layers on the specified frame are locked or unlocked, and any 
value passed for 1 ayerindex is ignored. 

Returns 

Nothing. 

Example 

The following command locks all the layers on the first frame. 
fw.getDocumentDOMl ) .setLayerLockedd , 0, true, true); 

dom.setLayerNameO 

Availability 

Fireworks 3 

Description 

Renames the specified layer. Layers aren’t required to have unique names, so no duplicate 
checking occurs. 

Arguments 

1 ayerindex, layerNanie 

• / ayerindex is a zero-based integer that specifies the layer to be renamed. To specify the 
current layer, pass - 1 . 

• 1 ay er Name is a string that specifies the new name for the layer. 

Returns 

Nothing. 
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dom.setLayerSharingO 

Availability 

Fireworks 3 

Description 

Changes the “shared” layer status of a layer. 

Arguments 

1 ayerlndex, sharedStatus, bUnshareCopI esToAl 1 Frames, bIJarnUser 

• 1 ayerlndex is a zero-based integer that specifies the layer to be shared or not shared. To 
specify the current layer, pass -1. 

• s/iarec/Status can be "shared" or "not shared". 

• bUnshareCopI esToAl 1 Frames is used only if sharedStatus is "not shared" and the 
document has multiple frames. If these conditions are met and bilnsha reCopi esToA 1 1 Frames 
is true, the items on the layer are duplicated to all the frames of the layer; if fal se, the items 
are placed only on the current frame. 

• If bIJarnUser is true and bUnshareCopI esToAl 1 Frames is enabled, the user is asked to 
confirm that data on other frames can be overwritten. If bUarnUser is fal se, data on other 
frames of the layer is overwritten without warning. 

Returns 

Nothing. 

Example 

The following command sets the selected layer to “shared” and displays a warning that data loss 

is possible. 

fw . getDocumentDOM( ) . setLayerShari ng ( - 1 , "shared", false, true); 

dom.setLayerVisibleO 

Availability 

Fireworks 3 

Description 

Shows or hides a layer on the specified frame. 

Arguments 

1 ayerlndex, frameindex, bShow, bAll Layers 

• 1 ayerlndex is a zero-based integer that specifies the layer that should be shown or hidden. To 
specify the current layer, pass -1. (To show or hide all the layers on a frame, use the 

bA 1 1 Layers argument.) 

• frameindex is a zero-based integer that specifies the frame that contains the layer to be shown 
or hidden. To specify the current frame, pass - 1 . 

• If bShoM is true, the layer is visible. If bShow is fal se, it is hidden. 

• If bAl 1 Layers is true, all the layers on the specified frame are shown or hidden, and any value 
that is passed for 1 ayerlndex is ignored. 
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Returns 

Nothing. 

dom.setMatteColorO 

Availability 

Fireworks 3 

Description 

Sets or removes the document’s matte color that is used for exporting. 

Arguments 

bUseMatteCol or , matteCol or 

• If bUseMatteCo 1 or is true, the document’s matte color is set to the value that is specified by 
matteCol or. If bUseMatteCo / or is fal se, any matte color is removed from the document, 
and the second argument is ignored. 

• matteCol or is 3. color string (see “Color string” on page 5). 

Returns 

Nothing. 

Example 

The following command sets the matte color to the specified value, which, in this case, is blue, 
fw . getDocumentDOM( ). set MatteCol or (true, "#0033ff"); 

dom.setPixelMaskO 

Availability 

Fireworks 3, deprecated in 4 in favor ofdom.setSelectionMaskl) (see 
“dom.setSelectionMaskO” on page 153). 

Description 

If Fireworks is in bitmap mode, this function sets the pixel-selection mask of the current image to 
the specified mask. 

Arguments 

mask, howToCombineMasks 

• mask is 3 mask variable that specifies the mask to be applied (see “Mask” on page 6). If ma.sk is 
null, any existing pixel-selection mask is removed. 

• If there was previously a mask and the new mask is also not null, then howToCombineMasks 
specifies how the two masks should be combined. Acceptable values for howToCombineMasks 
are "repl ace", "add", "subtract", and "i ntersect". 

Returns 

Nothing. 
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dom.setOnionSkinningO 

Availability 

Fireworks 3 

Description 

• Sets the onion-skin display options for the document. 

Arguments 

before, after 

• The arguments are integers that specify the number of frames to display before and after the 
current one. 

• To disable onion skinning, pass zero for both arguments. 

• To enable onion skinning for all frames, pass 0 for the first argument and a large number for 
the second argument (for example, 99,999). 

Returns 

Nothing. 

Example 

The following command turns on onion skinning two frames before the selected frame and zero 
frames after it. 

fw . getDocumentDOM( ) . setOni onSkinning(2, 0); 

dom.setOpacityO 

Availability 

Fireworks 3 

Description 

Sets the opacity of the selection to the specified value. 

Arguments 

opaci ty 

opaci ty is a float variable between 0 and 100, inclusive. 

Returns 

Nothing. 

Example 

The following command sets the selected item to an opacity of 55 percent, 
f w. ge t Document DOM ( ) .set0pacity(55) ; 

dom.setQuadrangleO 

Availability 

Fireworks 3 

Description 

Transforms the selection within a specified bounding quadrangle. The effect is the same as 
performing a Transform operation within Fireworks, and then replaying the Transform step from 
the History panel while other items are selected. 
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Arguments 

pTopLeft, pTopRi ght , pBottomRI ght , pBottoniLeft , options 

• The first four arguments are points that specify the x,y coordinates of the top left, top right, 
bottom right, and bottom left points of the bounding rectangle (see “Point” on page 6). 

• Acceptable values for opti ons are "transf ormAttri butes", "autoTrimlmages'', and 
''autoTrimlmages transf ormAttri butes ", 

Returns 

Nothing. 

Example 

The following command transforms the selection as specified. 

fw . getDocumentDOM( ) . setQuadrangl e( { x : -0 . 300884962 , y:0. 2079 64599), {x:l, 
y :0. 207964599) , {x:l, y : 0 . 792035401 ) , { x 0 . 300884962 , y : 0 . 792035401 ) , 
"autoTrimlmages transf ormAttri butes ") ; 

dom.setRectRoundnessO 

Availability 

Fireworks 4 

Description 

Modifies the corner roundness of all the selected rectangle primitives. 

Arguments 

roundness 

roundness is a float value between 0 and 1 that specifies the roundness to use for the corners (0 is 
no roundness, 1 is 100 percent roundness). 

Returns 

Nothing. 

Related functions 

dom . addNewRectangl ePri mi ti ve( ) , dom. setRectSi des ( ) 

dom.setRectSidesO 

Availability 

Fireworks 4 

Description 

Modifies the untransformed sides of all selected rectangle primitives. 

Arguments 

news Ides 

news ides is a rectangle that specifies the new untransformed sides of the rectangle primitive (see 
“Rectangle” on page 6). Rectangle primitives remember their transformations, so the user sees the 
transformed result of newSides in the document. 
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Returns 

Nothing. 

Related functions 

dom.setRectRoundness(), dom.addNewRectanglePrimitive() 

dom.setSelectionBoundsO 

Availability 

Fireworks 3 

Description 

Moves and resizes the selection in a single operation. 

Arguments 

boundl ngRectangl e , opts 

• boundl ngRectangl e is a rectangle that specifies the new location and size of the selection (see 
“Rectangle” on page 6). 

• Acceptable values for opts are " t ransf ormAttri butes", ''autoTrimImages'', and 
''autoTrimlmages t ransf ormAttri butes ". 

Returns 

Nothing. 

dom.setSelectionMaskO 

Availability 

Fireworks 4 

Description 

If Fireworks is in bitmap mode, this function sets the pixel-selection mask of the current image to 
the specified mask. 

Arguments 

mask, howToCombi neMasks 

• mask specifies the mask to be applied (see “Mask” on page 6). If mas/c is nul 1 , an existing pixel- 
selection mask is removed. 

• If there was previously a mask and mask is not nul 1 , howToCombI neMasks specifies how the 
two masks should be combined. Acceptable values are '' r e p 1 a c e " , "add", "subtract", 
and "intersect". 

Returns 

Nothing. 

dom.setShowEdgesO 

Availability 

Fireworks 3 

Description 

Specifies whether the Show Edges option is on or off 
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Arguments 

bShowEdges 

If bShowEdges is true, the Show Edges option is turned on. If bShowEdges is fal se, the option 
turned off 

Returns 

Nothing. 

dom.setShowGammaPreviewO 

Availability 

Fireworks 3 

Description 

Specifies whether the Preview Gamma option is on or off. 

Arguments 

bPrevi ewGairmia 

If bPrevI ewGamma is true, the Preview Gamma option is turned on. If bPrevI ewGanmia is fal se 
the option is turned off 

Returns 

Nothing. 

dom.setShowGridO 

Availability 

Fireworks 3 

Description 

Specifies whether the grid is visible. 

Arguments 

bShow 

If bShow is true, the grid is visible. If bShow is fal se, it is not visible. 

Returns 

Nothing. 
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dom.setShowGuidesO 

Availability 

Fireworks 3 

Description 

Specifies whether normal guides are visible. 

Arguments 

bShow 

If bShow is true, the normal guides are visible. If bShow is f al se, they are not visible. 

Returns 

Nothing. 

dom.setShowRulersO 

Availability 

Fireworks 3 

Description 

Specifies whether rulers are visible. 

Arguments 

bShow 

If bShow is true, the rulers are visible. If bShow is false, they are not visible. 

Returns 

Nothing. 

dom.setShowSliceGuidesO 

Availability 

Fireworks 3 

Description 

Specifies whether slice guides are visible. 

Arguments 

bShow 

If bShow is true, the slice guides are visible. If bShow is f al se, they are not visible. 

Returns 

Nothing. 
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dom.setShowSliceOverlayO 

Availability 

Fireworks 3 

Description 

Specifies whether the slice overlay is visible. 

Arguments 

bShow 

If bShow is true, the slice overlay is visible. If bShow is f al se, it is not visible. 

Returns 

Nothing. 

dom.setSliceAutonamingO 

Availability 

Fireworks 3 

Description 

If a single slice is selected, this function turns automatic naming on or off for the slice. 

Arguments 

bAutoname 

If bAutoname is true, automatic naming is turned on for the slice. If bAutoname is f al se, it 
is turned off 

Returns 

Nothing. 

dom.setSliceExportOptionsO 

Availability 

Fireworks 3 

Description 

Sets the Export Options for the selected slices. 

Arguments 

exportOptI ons 

exportOptI ons is an ExportOpti ons object (see “ExportOptions” on page 33). 

Returns 

Nothing. 
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dom.setSliceFilenameO 

Availability 

Fireworks 3 

Description 

If a single slice is selected, this function turns off automatic naming for the slice and sets its 
filename to the specified URL. 

Arguments 

fileURL 

fi 1 eilRL is a string, which is expressed as a file://URL, that specifies the name to be given to the 
slice. 

Returns 

Nothing. 

dom.setSliceGuideColorO 

Availability 

Fireworks 3 

Description 

Sets the color that is used to display slice guides. To set the color of normal guides, use 
dom.setGuideColor(). 

Arguments 

color 

col or is a color string (see “Color string” on page 5). 

Returns 

Nothing. 

dom.setSliceHtmlO 

Availability 

Fireworks 3 

Description 

If a single slice is selected, this function sets the slice’s HTML text. 

Arguments 

html Text 

html Text is z string that specifies the HTML text for the slice. 

Returns 

Nothing. 
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dom.setSlicelsHtmlO 

Availability 

Fireworks 3 

Description 

Sets the selected slices as HTML or Image. 

Arguments 

bHtnil 

If bHtml is true, it sets the slices as HTML. If bHtml is f al se, it sets the slices as Image. 

Returns 

Nothing. 

dom.setSnapT oGrid() 

Availability 

Fireworks 3 

Description 

Specifies whether tools snap to grid. 

Arguments 

bSnap 

If bSnap is true, the tools snap to grid. If bSnap is fal se, they do not. 

Returns 

Nothing. 

dom.setSnapT oGuides() 

Availability 

Fireworks 3 

Description 

Specifies whether tools snap to guides. 

Arguments 

bSnap 

If bSnap is true, the tools snap to all guides. If bSnap is fal se, they do not. 

Returns 

Nothing. 
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dom.setSymbolPropertiesO 



Availability 

Fireworks 3 

Description 

Sets the name and symbol type of the specified symbol. 

Arguments 

currentName . symbolType, newName 

• currentName specifies the current name of the symbol in the library. If more than one master 
exists with a name of currentName, only the first master is changed. If nul 1 is passed in for 
currentName, the name property is set for all selected symbols in the library (not the 
document) . 

• Acceptable values for syfflho? Type are "graphic", "button", and "animation". 

• newName specifies the new name for the symbol. 

Returns 

Nothing. 

dom.setT extAlignment() 

Availability 

Fireworks 3 

Description 

Sets the alignment of the selected text items to the specified setting. 

Arguments 

a 1 1 gnment 

Acceptable values for a 1 1 gnment are "left", "center", "right", "justify", "stretch", 
"vertical 1 eft", "verti cal center", "verti cal ri ght", "verti cal justify", and 
"vertical stretch". 

Returns 

Nothing. 

dom.setTextAntiAliasingO 

Availability 

Fireworks 3 

Description 

Sets the anti-aliasing level for the selected blocks of text. 

Note: To turn anti-aliasing on or off, call “dom.enableTextAntlAllasIngO" on page 89. 

Arguments 

level 

Acceptable values for level are "crisp", "smooth", and "strong". 

Returns 

Nothing. 
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dom.setTextAutoKernO 

Availability 

Fireworks 3 

Description 

Specifies whether automatic kerning is on or off for the selected text items. 

Arguments 

bKern 

If bKern is true, automatic kerning is on for the selected text items. If bKern is false, it is off 

Returns 

Nothing. 

dom.setT extCharSpacing() 

Availability 

Fireworks MX 

Description 

Sets the kerning for text. 

Arguments 

charSpace 

charSpace is a floating-point percentage of the default spacing to add to (positive values) or 
remove from (negative values) the space between two adjacent characters. To increase the spacing 
by 15 percent, for example, pass 0.15. 

Returns 

Nothing. 

dom.setT extFlow() 

Availability 

Fireworks 3 

Description 

Sets the horizontal flow direction of the selected text items. 

Arguments 

fl owD1 recti on 

Acceptable arguments for f/oivDi recti on are "1 eft to ri ght " and '' ri ght to left". 

Returns 

Nothing. 
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dom.setTextHorizontalScaleO 

Availability 

Fireworks MX 

Description 

Sets the horizontal scaling of text. For vertical text mode, this function stretches or compresses the 
height of the characters. 

Arguments 

hor1 zSca 1 e 

horizSca ?e is a floating-point number that describes how much to scale the text characters 
horizontally. 1.0 is normal. Values greater than 1.0 make the characters wider, and values less than 
1.0 make the characters narrower. 

Returns 

Nothing. 

dom.setTextLeadingO 

Availability 

Fireworks MX 

Description 

Sets the leading amount and leading mode for text. For vertical text mode, the leading is the space 
between two adjacent columns of text. 

Arguments 

1 ead1 ngVal ue, 1 eadi ngMode 

• 1 eadingVa 1 ueis a floating-point number that determines the spacing between two lines of 
text. The exact meaning of 1 eadi ngVal ue depends on 1 eadi ngMode. 

• 1 ead1 ngMode can be either "exact" or "percentage", "exact" means the 1 eadi ngVal ue is 
the number of pixels between two lines of text, "percentage" means the leadingValueisa 
percentage of the default leading amount; 1.0 is normal, 0.5 is close together, and 2.0 is 
double-spaced. 

Returns 

Nothing. 

dom.setTextOnPathModeO 

Availability 

Fireworks 3 

Description 

Sets the mode of the selected text-on-a-path items to the specified value. 
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Arguments 

mode 

Acceptable values for mode are "rotate", "vertical", "skew verti cal ", and "skew 
hori zontal 

Returns 

Nothing. 

dom.setT extOnPathOffset() 

Availability 

Fireworks 3 

Description 

Sets the offset for the selected text-on-a-path items to the specified distance. 

Arguments 

offset 

offset is a float value that specifies the offset distance in pixels. 

Returns 

Nothing. 

dom.setT extOrientation() 

Availability 

Fireworks 3 

Description 

Sets the horizontal/vertical text orientation of the selected text items. 

Arguments 

orientation 

Acceptable values for or? entat 7 017 are " hori zontal left to right", "verti cal right to 
1 eft", "horizontal right to 1 eft", and "verti cal left to right". 

Returns 

Nothing. 

dom.setTextParaIndentO 

Availability 

Fireworks MX 

Description 

Sets the paragraph indent for text. Paragraph indent is the amount to indent the first line of a 
paragraph in pixels. 
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Arguments 

paraindent 

para Indent is the number of pixels to indent the first line of a paragraph. 

Returns 

Nothing. 

dom.setTextParaSpacingAfterO 

Availability 

Fireworks MX 

Description 

Sets the after-paragraph spacing for text; that is, the number of pixels to move down after a 
paragraph before starting the next paragraph. For vertical text mode, this function defines the 
distance to move vertically before or after starting a new paragraph. 

Arguments 

paraSpaceA fter 

paraSpaceA fter is the number of pixels to place after a paragraph before starting the next 
paragraph. 

Returns 

Nothing. 

dom.setTextParaSpacingBeforeO 

Availability 

Fireworks MX 

Description 

Sets the before-paragraph spacing for text; that is the number of pixels to move down before 
starting a new paragraph. For vertical text mode, this function defines the distance to move 
vertically before or after starting a new paragraph. 

Arguments 

paraSpaceBefore 

paraSpaceBefore is the number of pixels to move down before starting a new paragraph. 

Returns 

Nothing. 

dom.setT extRuns() 

Availability 

Fireworks 3 

Description 

Replaces the text in the selected text blocks with the styled text that is described by the TextRuns 
object passed in the argument. 
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Arguments 

textRuns 

The argument is a TextRuns object (see “TextRuns” on page 44). 

Returns 

Nothing. 

dom.setT ransformMode() 

Availability 

Fireworks 3 

Description 

Sets the transform mode for the selected text, instance items, or both. 

Arguments 

mode 

Acceptable values for mode are "paths" and "pixel s". 

Returns 

Nothing. 

dom.setTextRectangleO 

Availability 

Fireworks 3 

Description 

Changes the bounding rectangle for the selected text item to the specified size. This function 
causes the text to reflow inside the new rectangle; the text item is not scaled or transformed. Text 
that does not fit into the new rectangle does not show. 

Arguments 

boundl ngRectangl e 

boundi ngRectangl e is a rectangle that specifies the new size within which the text item should 
flow (see “Rectangle” on page 6). 

Returns 

Nothing. 

dom.setT extRectangleAuto() 

Availability 

Fireworks 3 

Description 

Recalculates the bounding rectangle for the selected text item, setting the rectangle to the smallest 
box that encloses the text. 

Arguments 

None. 
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Returns 

Nothing. 

Related functions 

dom . setText Recta ngl eAu to FromPoi nt( ) 

dom.setTextRectangleAutoFromPointO 

Availability 

Fireworks 3 

Description 

Performs the same function as dom. setTextRectangl eAuto( ), but lets you pass a point to 
specify where the rectangle should be located. 

Arguments 

anchorPol nt 

anchorPoi nt is a point that specifies the x,y coordinates of the location at which the text box 
should be anchored (see “Point” on page 6). How the point is used depends on the left-to-right 
and up-to-down orientation of the text flow in the text block. 

• Left-justified horizontal text is placed with its top and left edges at anchorPoi nt, and the text 
expands to the right. 

• Centered horizontal text is centered horizontally around anchorPoi nt and expands equally to 
the left and right. 

• Centered vertical text is centered vertically around anchorPoi nt and expands equally up and 
down. 

Returns 

Nothing. 

Related functions 

dom . setTextRectangl eAu to ( ) 

dom.showAIIHiddenO 

Availability 

Fireworks 3 

Description 

Shows all the items that were hidden by using dom. hideSelection(). 

Arguments 

None. 

Returns 

Nothing. 
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dom.splitPathsO 

Availability 

Fireworks 3 

Description 

Splits the selected paths. Compound paths are split into separate contours. 

Arguments 

None. 

Returns 

Nothing. 

dom.swapBrushAndFMIColorsO 

Availability 

Fireworks 3 

Description 

Swaps the current brush color and current fill color. This function has no effect on any selected 
items. 

Arguments 

None. 

Returns 

Nothing. 

dom.transformSelectionO 

Availability 

Fireworks 3, enhanced in 4 

Description 

Transforms the selection using the specified three-by-three matrix. 

Arguments 

matrix, options 

• matrix is 3. three-by-three transformation matrix (see “Matrix” on page 6). 

• Acceptable values for opti ons, some of which were added in Fireworks 4, are '' '' , 
''transforniAttributes", "autoTrimImages", "autoTrimlmages 
transforniAttri butes " , " rememberQuad" , "transforniAttributes rememberQuad" , 
"autoTrimlmages rememberQuad", and "autoTrimlmages transformAttri butes 
rememberQuad" . 

Returns 

Nothing. 
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dom.tweenO 

Availability 

Fireworks 3 

Description 

Tweens between the two selected instances. 

Arguments 

numSteps, bDi stri bute 

• numSteps is an integer that specifies how many new instances are generated. 

• If bOi stri bute is true, the new instances are distributed to frames. 

Returns 

Nothing. 

dom.undoO 

Availability 

Fireworks 3 

Description 

Undoes the most recent step performed, as long as that step is actually “undoable.” Most (but not 
all) JavaScript functions create an “undoable” action to be executed. 

Arguments 

None. 

Returns 

Nothing. 

dom.updateSymbolO 

Availability 

Fireworks 3 

Description 

Updates the specified linked symbol. 

Arguments 

name 

name specifies the name of the symbol in the library. If more than one symbol exists with a name 
of name, then only the first symbol with that name is updated. If nul 1 is passed in for name, then 
all the selected linked symbols in the library (not the document) are updated. 

Returns 

Nothing. 
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dom.ungroupO 

Availability 

Fireworks 3 

Description 

Ungroups any grouped items in the selection. To group items, use dom.groupi ). 

Arguments 

None. 

Returns 

Nothing. 

Fireworks functions 

In Fireworks MX, fw is synonymous with f i reworks . All methods of the f i reworks object can 
be referred to as fi reworks . functi onName( ) or as fw. functi onName( ). 

fw.browseDocumentO 

Availability 

Fireworks 3 

Description 

Opens the user’s primary browser and displays the specified URL. 

Arguments 

URL 

URL is the URL of the page appear in the browser. Any legal URL (including http://, ftp://, and so 
on) can be passed. Fireworks does not check this argument for syntax; if you pass an illegal value, 
the browser does not open the URL. 

Returns 

Nothing. 

fw.browseForFileURLO 

Availability 

Fireworks 3 

Description 

Displays an Open or Save dialog box for the user. 

Arguments 

browseType, title, prevlewArea 

• Acceptable values for browseType are "open", "select", and " s a v e ". The first two values 
display an Open dialog box; each is acceptable for compatibility with Dreamweaver. The third 
value displays a Save dialog box. 

• title and prevlewArea are ignored by Fireworks but are accepted for compatibility with 
Dreamweaver. 
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Returns 

The file URL selected by the user, or nul 1 if the dialog box was canceled. 

fw.browseForFolderURLO 

Availability 

Fireworks 3 

Description 

Displays a dialog box that lets a user select a particular directory. 

Arguments 

[title], { startFol der] 

• 1 7 1 ? e is an optional string that specifies a title for the dialog box that appears. If it is omitted 
or n u 1 1 , a default title appears. 

• StartFol der is an optional string that serves as the root directory for the dialog box that 
appears. If it is omitted or nul 1 , the browse dialog box displays an unspecified directory, 
depending on your system configuration. Generally, it is the last directory used. 

fw.browseHelpO 

Availability 

Fireworks MX 

Description 

Opens the specified help topic in the help viewer. 

Arguments 

helpID 

hel pi D is the index number of the help topic to view. 

Returns 

Nothing. 

fw.checkFwJsVersionO 

Availability 

Fireworks 3 

Description 

Checks the JavaScript API for incompatibilities. 

Arguments 

vers 1 on 

vers 7 on is an integer that is reserved for future use; only a value of 0 is supported at this time. To 
use this function, put a call to fw. checkFwJs Vers ion(O) in your script. 

Returns 

Nothing. 
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fw.chooseBrowserO 

Availability 

Fireworks MX 

Description 

Displays a dialog box that lets the user select a primary or secondary browser. 

Arguments 

prmaryBrowser 

pr1 maryBrowser is a Boolean value that indicates which browser to select. If prmaryBrowser is 
true, Fireworks prompts the user to set the primary browser; if the argument is f al se, Fireworks 
prompts the user to set the secondary browser. 

Returns 

Nothing. 

fw.chooseScriptTargetDialogO 

Availability 

Fireworks 4 

Description 

Displays a dialog box that lets the user choose the target document(s) for an operation. The dialog 
box lets the user specify the files currently open, the files in the project list, or files that are 
explicitly selected. 

Arguments 

format! 1st 

format! 1 st is similar to fw.locateDocDialog(), except that format ! 1 st is required, and you 
cannot specify a maximum number of documents (see “fw.locateDocDialogO” on page 183). 

Returns 

An array of file://URLs, or nul 1 if the dialog box is canceled. 

fw.closeDocumentO 

Availability 

Fireworks 3 

Description 

Closes the specified document. 

Arguments 

document, { bPromptToSaveChanges} 

• document is a Document object that specifies the document to close (see “Document” on page 

9). 

• If bPromptToSaveChanges is true or omitted, and the document has changed since the last 
time it was saved, the user is prompted to save changes to the document. If 
bPromptToSaveChanges is false, the user is not prompted and any changes to the document 
are discarded. 
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Returns 

Nothing. 

fw.createDocumentO 

Availability 

Fireworks 3 

Description 

Opens a new document and selects it. Values for size, resolution, and color are the same as the 
current defaults. To specify values other than the defaults, use fw . createFi reworksDocument ( ). 

Arguments 

None. 

Returns 

The Document object for the newly created document (see “Document” on page 9). 

fw.createFireworksDocumentO 

Availability 

Fireworks 3 

Description 

Opens a new document and selects it. Values for size, resolution, and color are explicitly specified. 
To open a new document with the default values, use fw.createDocument( ). 

Arguments 

size, res, backgroundCol or 

• s 7ze is a point whose x value specifies the document’s width and whose jy value specifies the 
document’s height. Both values are pixels. 

• res specifies the resolution for the scaled document (see “Resolution” on page 6). 

• backgroundCol or is a color string (see “Color string” on page 5). 

Returns 

The Document object for the newly created document (see “Document” on page 9). 

Example 

The following command creates a new document that is 500 by 500 pixels in size, with a 
resolution of 72 dpi, and a solid white background color. 

fw. createFi reworksDocument ( {x:500,y:500),{pixelsPerUnit:72, units: ''inch''), 

fw.dismissBatchDialogWhenDoneO 

Availability 

Fireworks 4 

Description 

Closes the Batch Progress dialog box automatically when the script finishes. This function has no 
effect if the Batch Progress dialog box does not appear. 
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Note: This function is used mostly for backward compatibility with Fireworks 2. 

Arguments 

autoClose 

autoCl ose is 3 . Boolean value. If set to true, the Batch Progress dialog box closes automatically 
(without user intervention) when the script finishes. 

Returns 

Nothing. 

fw.exportAndCopyHTMLCodeO 

Availability 

Fireworks MX 

Description 

Displays the export dialog box, which is preconfigured to export HTML and images and to copy 
the HTML code to the Clipboard. 

Arguments 

document 

document is a Document object (for example, fw.documents[2]) that specifies the document to 
export. If document is nul 1 , the active document is exported. 

Returns 

A Boolean value: true if successful; false otherwise. 

fw.exportDirectorAsSlicesO 

Availability 

Fireworks MX 

Description 

Exports the specified document to the specified file as Director images. 

Arguments 

document, fUeURL 

• document isaDocument object (for example, fw. documents [2] ) that specifies the document 
to export. If document is nul 1 , the active document is exported. 

• fi 1 eilRL specifies the filename for the exported file. If fil eURL is nul 1 , Fireworks displays the 
Export dialog box. 

Returns 

A Boolean value: true if successful; false otherwise. 
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fw.exportDirectorAsLayersO 

Availability 

Fireworks MX 

Description 

Exports the specified document to the specified file as layers to be imported into Macromedia 
Director. 

Arguments 

document, fUeURL 

• document is a Document object (for example, fw.documents[2] ) that specifies the document 
to export. If document is nul 1 , the active document is exported. 

• fi 1 eilRL specifies the filename for the exported file. If fil eURL is nul 1 , Fireworks displays the 
Export dialog box. 

Returns 

A Boolean value: true if successful; false otherwise. 

fw.exportDocumentAsO 

Availability 

Eireworks 3 

Description 

Exports the specified document to the specified file. 

Arguments 

document, fUeURL, exportOptI ons 

• document is a Document object (for example, fw.documents[2]) that specifies the document 
to be exported. If document is nul 1 , the active document is exported. 

• fi 1 eilRL is a string, which is expressed as a file://URL, that specifies the filename for the 
exported file. If f i 1 elJRL is nul 1 , the Save As dialog box is displayed. 

• exportOpti ons is an ExportOpti ons object (see “ExportOptions” on page 33). If 
exportOpti ons is nul 1 , the document’s current export options are used. If the file format 
specified by exportOpti ons conflicts with the file format specified by fi 1 etlRL, then the 
extension of fi 1 eilRL is changed to match the format specified by exportOpti ons. 

Returns 

Nothing. 

Related functions 

fw.exportHtmlAndlmagesl) 

fw.exportlllustratorO 

Availability 

Fireworks MX 

Description 

Exports the specified document to the specified file in Adobe Illustrator format. 
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Arguments 

document, fUeURL 

• document isaDocument object (for example, fw. documents [2] ) that specifies the document 
to export. If document is nul 1 , the active document is exported. 

• fi 1 eilRL specifies the filename for the exported file. If fil eURL is nul 1 , Fireworks displays the 
Export dialog box. 

Returns 

A Boolean value: true if successful; false otherwise. 

fw.exportPSDO 

Availability 

Fireworks MX 

Description 

Exports the specified document to the specified file in Adobe Photoshop format. 

Arguments 

document, flleURL 

• document isaDocument object (for example, fw. documents [2] ) that specifies the document 
to export. If document is nul 1 , the active document is exported. 

• fi 1 eURL specifies the filename for the exported file. If fi 1 eURL is n u 1 1 , Fireworks displays the 
Export dialog box. 

Returns 

A Boolean value: true if successful; false otherwise. 

fw.exportSWFO 

Availability 

Fireworks MX 

Description 

Exports the specified document to the specified file in Macromedia Flash SWF format. 

Arguments 

document, fileURL 

• document is a Document object (for example, fw.documents[2] ) that specifies the document 
to export. If document is nul 1 , the active document is exported. 

• fileURL specifies the filename for the exported file. If fil eURL is nul 1 , Fireworks displays the 
Export dialog box. 

Returns 

A Boolean value: true if successful; false otherwise. 
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fw.exportFramesO 

Availability 

Fireworks 4 

Description 

Exports a document’s frames as individual images. The images are named based on the names in 
the Frames panel. 

Arguments 

docObject, dIrectoryURL 

• docObject is a Document object that specifies the document that contains the frames to export 
(see “Document” on page 9). To export frames from the current document, pass null. 

• di rectory URL is the directory where the images will be placed, which is expressed as a file:// 
URL. 

Example 

The following command exports the frames in the current document to the C:\images directory. 
fw.exportFrameslnull , "file:///C|/i mages"); 

fw.exportHtmlAndImagesO 

Availability 

Fireworks 4 

Description 

Exports one image if the document contains no slice objects and multiple images if the document 
contains one or more slice objects. It also optionally exports HTML. The document is exported 
using the current export settings and export options. 

Arguments 

doc, htmlUrl, magesUrl 

• doc is a Document object that specifies the document to be exported (see “Document” on page 
9). If doc is nul 1 , the active document is exported. 

• htijil Ur 1 is the filename for the exported HTML file, which is expressed as a file://URL. If 
html Url is n u 1 1 , no HTML is generated. 

• i magesUrl is the filename for the exported image(s), which is expressed as a file://URL, and 
might not be nul 1 . If a single image is generated, this function uses images Url as the filename 
for the image. If multiple sliced images are exported, it uses imagesURL to generate 
automatically named images, and all images are placed in this directory. 

Returns 

Nothing. 

Example 

The following command exports the current document as HTML and as one or more images. 

fw.exportHtmlAndlmageslnull , "file:///C|/mysite/nav.htm", "file:///C|/mysite/ 
i mages/nav . gi f " ) ; 

Related functions 

fw . export Document As ( ) 
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fw.exportLayersO 



Availability 

Fireworks 4 

Description 

Exports a document’s layers as individual images. The images are named based on the names in 
the Layers panel. The layers from the current frame are exported. 

Arguments 

docObject, dIrectoryURL 

• docObject is a Document object that specifies the document that contains the layers to export 
(see “Document” on page 9). To export layers from the current document, pass null. 

• di rectory URL is the directory in which the images will be placed, which is expressed as a file:/ 
/URL. 

Example 

The following command exports the layers in the third open document to the 
C:\images directory. 

fw.exportLayers(fw.documents[2], "file:///C|/i mages"); 

fw.exportPSDO 

Availability 

Fireworks 4 

Description 

Exports a Fireworks document as a Photoshop document. 

Arguments 

docObject, PSDDocunientURL 

• docObject is a Document object that specifies the document to export (see “Document” on 
page 9). To export the current document, pass null. 

• PSDDocunientURL is the name of the Photoshop document to be created, which is expressed as 
a file://URL. 
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Example 

The Photoshop writer is controlled by the values of several preferences. See the following example 
for allowed values. A well-behaved script should restore the original values after exporting the file. 

var prevWarn = fw. getPref ( " PsdExport_WarnlOO" ) ; // bool 
fw.setPref( ''PsdExport_WarnlOO" , false); // don’t warn. 

var kObjToLayer = 1; 
var kFl atten = 2 ; 

var prevLayers = fw. getPref ( " PsdExport_Layers " ) ; 

fw . setPref ( '' PsdExport_Layers " , kObjToLayer) ; // flatten layers or not. 

var kEffectEdi tabl e = 1; 
var kEffectRender = 2; 

var prevEffects = fw. getPref (" PsdExport_Eff ects ") ; 
fw.setPref( '' Psd Expo rt_Eff ects ", kEffectEdi tabl e) ; 

var kTextEdi tabl e = 1; 
var kTextRender = 2; 

var prevText = fw. getPref (" PsdExport_Text" ) ; 
fw.setPref( "PsdExport_Text" , kTextRender) ; 

fw . exportPSD( nul 1 , "fi 1 e: ///C | /new f ol der/test . psd" ) ; 

// Put the prefs back. 

fw.setPrefl "PsdExport_WarnlOO" , prevWarn); 
fw.setPref( " PsdExport_Layers " , prevLayers) ; 
fw.setPrefl " Psd Expo rt_Eff ects ", prevEffects); 
fw.setPrefl "PsdExport_Text" , prevText) ; 

fw.exportSWFO 

Availability 

Fireworks 4 

Description 

Exports a Fireworks document as a Macromedia Flash document. 

Arguments 

docObject, FI ashOocumentURL 

• docObject is a Document object that specifies the document to be exported (see “Document” 
on page 9). To export the current document, pass null. 

• FI ashOocumentURL is the name of the Macromedia Flash document to be created, which is 
expressed as a file;//URL. 
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Example 

The Macromedia Flash writer is controlled hy the values of several preferences. See the following 
example for allowed values. A well-hehaved script should restore the original values after 
exporting the file. 

var prevMai ntai nObj Edi tabl e = fw. getPref ( "SwfMai ntai nObj Edi tabl e" ) ; 
fw.setPref( "SwfMai ntai nObj Edi tabl e" , true) ; 

// maintain non-text editability 
//at expense of appearance or not 

var prevMai ntai nTextEdi tabl e = fw. getPrefl "SwfMai ntai nTextEdi tabl e" ) ; 
fw.setPref( "SwfMai ntai nTextEdi table", false); 

// maintain text editability 
// at expense of appearance or not 

var prevExportAl 1 Frames = fw. getPrefi "SwfExportAl 1 Frames ") ; 
fw.setPrefl "SwfExportAl IFrames", true); 

// if true all frames are exported 

var prevExportFromFrame = fw. getPref ( "Swf ExportFromFrame" ) ; 
fw.setPrefl "Swf ExportFromFrame" , 1) ; 

// from frame; only used i f Swf ExportAl 1 Frames is false 
var prevExportToFrame = fw. getPref ( "Swf ExportToFrame" ) ; 
fw.setPrefl "Swf ExportToFrame" , 5) ; 

// from frame; only used if Swf ExportAl 1 Frames is false 

var prevJpegQual i t = fw. getPref ( "Swf JpegQual i ty" ) ; 
fw.setPref( "SwfJpegQual ity" , 85); // JPEG quality 

var prevFrameRate = fw. getPref ( "Swf FrameRate" ) ; 
fw.setPrefl "SwfFrameRate" , 5); // frame rate 

fw . exportSWFl nul 1 , "fi 1 e; ///C | /new f ol der/test . swf " ) ; 

// Put the prefs back. 

fw.setPrefl "SwfMai ntai nObj Edi tabl e" , prevMai ntai nObj Edi tabl e) ; 
fw.setPrefl "SwfMai ntai nTextEdi table", prevMai ntai nTextEdi table); 
fw.setPrefl "SwfExportAl 1 Frames" , prevExportAl 1 Frames) ; 
fw.setPrefl "Swf ExportFromFrame" , prevExportFromFrame); 
fw.setPrefl "Swf ExportToFrame" , prevExportToFrame) ; 
fw.setPrefl "SwfJpegQual ity" , prevJpegQual it) ; 
fw.setPrefl "Swf FrameRate" , prevFrameRate); 

fw.findAppO 

Availability 

Fireworks MX 

Description 

Attempts to find the path to the requested application. On the Macintosh, Fireworks looks for 
the application using a four-character signature code. On Windows, Fireworks looks in the 
Windows registry under 

HKEY_LOCAL_MACHINE\SQFTWARE\Mi crosoft\Wi ndows\CurrentVersi on\App Paths. 

Arguments 

macAppSI gnature or wi nExeRegi stryName 

• macAppSi gnature ISA Macintosh-specific string that identifies the signature of the application 
to find, such as "MKBY". 

• wi nExeRegi StryName is a Windows-specific string that identifies the name of an executable to 
find in the Windows registry, such as "Fi reworks.exe". 
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Returns 

A URL to the application. This URL can be passed as an argument to fw . 1 aunchApp( ) on page 
182. If no such application can be found, the URL is empty. 

fw.findNextO 

Availability 

Fireworks 3 

Description 

Finds the next instance of the current search string and selects that section of the document. To 
begin a search, use fw . setUpFi ndRepl ace( ). 

Arguments 

None. 

Returns 

The number of items that are replaced if the search is completed, or - 1 if there are items in the 
document that remain to be searched. 

fw.findOpenDocumentO 

Availability 

Fireworks 3 

Description 

Determines whether the specified file is open in a Fireworks document window. 

Arguments 

docname 

docname is a string that specifies the name of the document, which is expressed as a file://URL. 

Returns 

If the document is open, it returns the Document object; otherwise, it returns null (see 
“Document” on page 9). 

fw.getDocumentDOMO 

Availability 

Fireworks 3 

Description 

Returns the Document object for the active document (see “Document” on page 9). 

Arguments 

{ wh1 ch-str1 ng] 

whi ch - stri ng is an optional string that is included for compatibility with Dreamweaver. If 
specified here, it must be " document" . 

Returns 

The Document object for the active document, or nul 1 if no document is open. 
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fw.getDocumentPathO 



Availability 

Fireworks 3 

Description 

Gets the path and filename of the specified document. 

Arguments 

document 

The document is a Document object (for example, fw. documents [2]) that specifies the 
document whose path and filename should be retrieved. If document is nul 1 , information about 
the active document is retrieved. 

Returns 

The file URL for the document if it was saved or an empty string if it has not been saved. 

fw.getFloaterGroupingsO 

Availability 

Fireworks 3 

Description 

Gets an array of arrays that indicates the tab-grouping of the panels (even hidden ones). 

Arguments 

None. 

Returns 

An array that looks like the following example: 

[ [ ''stroke'', "fill", "effect" ], [ "layers", "frames", "object" ], [ "mixer", 
"options", "swatches", "info" ], [ "styles", "library" ], [ "find", "project 
log" ], [ "url" ], [ "optimize", "optimized colors" ], [ "behaviors" ], [ 
"history" ] ] 

fw.getFloaterPositionO 

Availability 

Fireworks 3 

Description 

Gets the screen position and size of the specified panel. 

Arguments 

panel Name 

Acceptable values for pane? /Vame are "find", "project log", "object", "info", "url", 
"effect", "history", "mixer", "fill", "stroke", "swatches ", "layers", "frames ", 
"behaviors", "optimize", " 1 i bra ry ", "styl es ", "optimized colors", "options", and 
"tool box". 

Returns 

A rectangle that specifies the bounds of the panel (see “Rectangle” on page 6). 
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fw.getFloaterVisibilityO 

Availability 

Fireworks 3 

Description 

Checks to see if a specified panel is visible. 

Arguments 

panel Name 

Acceptable values for panel Name are ''find", "project log", "object", "info", "url", 
"effect", "history", "mixer", "fill", "stroke", "swatches ", "layers", "frames ", 
"behaviors", "optimize", "library", "styl es ", "optimized colors", "options", and 
"tool box". 

Returns 

true if the specified panel is visible; false otherwise. 

fw.getHideAllFloatersO 

Availability 

Fireworks 3 

Description 

Returns the hidden or visible status of the panels. 

Arguments 

None. 

Returns 

true if the panels are hidden; false otherwise. 

fw.getHTMLFileForScriptO 

Availability 

Fireworks MX 

Description 

Returns an HTML file 

Arguments 

None. 

Returns 

A file URL. 
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fw.getNumberOfTablesO 



Availability 

Fireworks MX 

Description 

Returns the number of top-level (that is, non-nested) tables in a document. 

Arguments 

f1 1 ename 

fi 1 ename is the name of the fde that contains the tables to be counted. 

Returns 

A long integer that represents the number of tables in the document. 

fw.getPrefO 

Availability 

Fireworks 3 

Description 

Returns the Preference value (string or numeric) that is associated with the specified Preference 
key. 

Arguments 

prefkey 

prefkey is a string that specifies the Preference value to return. A complete list of these values is 
beyond the scope of this documentation, but the format of prefkey exactly matches that in the 
Fireworks Preferences file. To set a Preference value, use fw.setPrefi ). 

Returns 

A string or numeric Preference value. 

fw.launchAppO 

Availability 

Fireworks MX 

Description 

Launches an application using a file URL that is returned by fw.fi ndApp ( ) on page 178. You 
can specify, optionally, files to open in the application. 

Arguments 

appPath, fi 1 ePathsToOpen 

appPath is a file URL that specifies the executable to launch. Typically, this value can be obtained 
by calling fw . f i ndApp ( ) on page 178. 

f 7 1 ePa thsToOpen is an array of file URLs to open in the executable to launch. It is safe to pass an 
empty array. 

Returns 

A Boolean value that indicates whether the application launched successfully. 
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fw.launchBrowserT o() 

Availability 

Fireworks MX 

Description 

Launches Fireworks’ primary web browser to view a URL. 

Arguments 

url 

url identifies the URL to open in the primary web browser. 

Returns 

Nothing. 

Example 

The following command launches a browser to view the Macromedia website: 
fw.launchBrowserToC'http: //www. macromedi a . com" ) ; 

fw.locateDocDialogO 

Availability 

Fireworks 4 

Description 

Displays a dialog box that lets the user choose one or more files. For syntax details, see “Using 
fw.locateDocDialogO” on page 20. 

Arguments 

maxnumdocs, formatlist 

• maxnumdocs specifies the maximum number of documents to choose. 

• forma tl i st is a list of acceptable file types to open. 

Returns 

An array of file:// URLs, or nul 1 if the dialog box is canceled. 

fw.openDocumentO 

Availability 

Fireworks 3, enhanced in 4 

Description 

Opens the specified file(s) in new document windows. If a file is already open, it opens again; to 
avoid redundant opens, call fi ndOpenDocument( ) first. 
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Arguments 

[fileURL], IbOpenAsNew] 

• f 7 1 eilRL is a string or an array of strings, where each is expressed as a file://URL, that specifies 
the file(s) to be opened. If fi 1 eilRL is omitted or nul 1 , the Open Document dialog box 
appears. 

• If bOpenAsNew, which was added in Fireworks 4, is true, the document(s) open as unsaved and 
untitled. If bOpenAsNew is false (the default value), they open with their original names. 

Returns 

If any of the file(s) can open, it returns the Document object for each file. Returns null if none of 

the documents can open. 

fw.popupColorPickerO 

Availability 

Fireworks MX 

Description 

Opens the pop-up color swatches dialog to let the user visually select a color. 

Arguments 

screenLoc, initialColor, all ouTransparent , forceUeb216 

• screenLoc is the location at which the dialog appears, in the form of a point [x: f 1 oat, y: 
f 1 oat I (see “Point” on page 6 for syntax details). 

• i ni ti a 1 Col or is the initially selected color in the dialog, in the form #rrggbbaa (see “Color 
string” on page 5 for syntax details). 

• all owTransparent is a Boolean value that lets the user select a transparent color; set to true 
for transparent, fal se otherwise. 

• forcehlebZl 6 is a Boolean value that forces the chosen color to fall within the web2l6 panel; 
set to true to force the color change, false otherwise. 

Returns 

The chosen color is formatted as#rrggbbaa (see “Color string” on page 5 for syntax details). 

fw.popupColorPickerOverMouseO 

Availability 

Fireworks MX 

Description 

Opens the pop-up color swatches dialog at the current mouse location to let the user visually 

select a color. 

Arguments 

1 n1 11 al Col or , al 1 owTransparent , forceltlebZlC 

• i ni ti al Col or is 3 . color string formatted as#rrggbbaa (see “Color string” on page 5 for 
syntax details), which is the initially selected color in the dialog. 

• all owTransparent is a Boolean value that lets the user select a transparent color; set to true 
for transparent, fal se otherwise. 



184 Chapters 




• forcehlebZl 6 is a Boolean value that forces the chosen color to fall within the web2l6 panel; 
set to true to force the color change, false otherwise. 

Returns 

The chosen color is formatted as#rrggbbaa (see “Color string” on page 5 for syntax details). 

fw.quitO 

Availability 

Fireworks 4 

Description 

Identical to fw . qui tAppl i cati on ( ). 

fw.quitApplicationO 

Availability 

Fireworks 3 

Description 

Quits Fireworks, but prompts the user to save any changed documents before exiting. 

Arguments 

None. 

Returns 

Nothing. 

fw.readNthTableO 

Availability 

Fireworks MX 

Description 

Reads the table that the parameter indicates. The tables are zero-indexed. 

Arguments 

filename, tablenumber 

fi 1 ename is a f1 1 eURL for the fde that contains the desired table. 

tabl enumber is a long integer that specifies the desired table; the tables are zero-indexed. 

Returns 

A database that is constructed from the table data. 
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fw.readPanelStateFromFileO 



Availability 

Fireworks MX 

Description 

Reads in a panel state file, which is generated by the fw.writePanelStateToFile function, 
and moves the panels. Property inspector, and toolbox to the appropriate locations. 

Arguments 

f1 lepath 

fi 1 epa th is the location of the panel state file as a string in the format file://URL. 

Returns 

Nothing. 

fw.replaceO 

Availability 

Fireworks 3 

Description 

Verifies that the selection matches the current search string and replaces it with the replacement 
string. 

Arguments 

None. 

Returns 

The number of items that are replaced, or - 1 if there are items in the document that remain to be 
searched. 

Related functions 

fw.setUpFindReplace() 

fw.replaceAllO 

Availability 

Fireworks 3 

Description 

Performs a Replace All operation on the active document using the current search-and- 
replacement strings. 

Arguments 

None. 

Returns 

The number of items replaced, or - 1 if the search is not yet complete. 

Related functions 

fw.setUpFindReplace() 
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fw.revertDocumentO 

Availability 

Fireworks 3 

Description 

Reverts the specified document to its previously saved version. 

Arguments 

{ document] 

document is a Document object (for example, fw.documents[2]) that specifies the document to 
revert. If document is omitted or nul 1 , the active document reverts. 

Returns 

Nothing. 

fw.runScriptO 

Availability 

Fireworks 3 

Description 

Executes a JavaScript file. 

Arguments 

f1 1 ename 

fi 1 ename is the name of the script file to execute. If fi 1 ename is not a file URL (that is, it does 
not begin with ''file:///''), it is assumed to be the name of a file in the Fireworks MX/ 
Configuration/Commands folder. 

Returns 

Result of script. 

Example 

The following command runs a script found in the Align Center to Document.jsf file, which is 
located in the Commands folder. 

fw. runScri pt( "A1 ign Center to Document.jsf"); 

fw.saveAllO 

Availability 

Fireworks 3 

Description 

Saves all open documents, displaying the Save As dialog box for any documents that were not 
previously been saved. 

Arguments 

None. 

Returns 

Nothing. 
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fw.saveDocumentO 

Availability 

Fireworks 3 

Description 

Saves the specified document as a native Fireworks PNG file with the specified name. To save a 
document to another format, such as GIF or JPEG, use fw . exportDocumentAs ( ) . 

Arguments 

document, {fUeURL] 

• document is a Document object (for example, fw.documents[2]) that specifies the document 
to be saved. If document is null, the active document is saved. 

• f 7 1 eilRL is the name of the saved document, which is expressed as a file://URL. If fi 1 eilRL is 
null or omitted, the document is saved with its current name; if the document has not been 
saved, the Save As dialog box appears. 

Returns 

Nothing. 

fw.saveDocumentAsO 

Availability 

Fireworks 3 

Description 

Displays the Save As dialog box for the specified document, so it can be saved as a native 
Fireworks PNG file with the specified name. To save a document to another format, such as GIF 
or JPEG, use fw . exportDocumentAs ( ). 

Arguments 

document 

document is a Document object (for example, fw.documents[2]) that specifies the document to 
save. If document is null, the active document is saved. 

Returns 

The file URL for the saved document, or nul 1 if the dialog box was canceled. 

fw.saveDocumentCopyAsO 

Availability 

Fireworks 3 

Description 

Saves a copy of the specified document as a native Fireworks PNG file with the specified name. 
To save a document to another format, such as GIF or JPEG, use fw . exportDocumentAs ( ) . 
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Arguments 

document, fUeURL 

• document is a Document object (for example, fw.documents[2]) that specifies the document 
to be saved. If document is null, the active document is saved. 

• f 7 1 eilRL is the filename for the saved file, which is expressed as a file://URL. If fi 1 eURL is 
null, the Save As dialog box appears. 

Returns 

The file URL for the saved document, or n u 1 1 if the dialog box was canceled. 

fw.saveJsCommandO 

Availability 

Fireworks 3 

Description 

Saves the specified string of JavaScript code as a JSF command file. 

Arguments 

jscode, filename 

• jscode specifies the string of code to be saved as a JSF command file. 

• fi 1 ename specifies the name in which the file should be saved. If fi 1 ename is not a file URL 
(that is, it does not begin with ''file:///''), the file is saved in the Fireworks MX/ 
Configuration/Commands folder. 

Returns 

Nothing. 

fw.setActiveViewScaleO 

Availability 

Fireworks MX 

Description 

Sets the zoom amount and the center of the view for the current document. 

Arguments 

scale, center 

• sea ?e is a floating-point number where 1.0 is 100 percent, or normal view. 

• center is a point that defines the location in the document to center the view. This argument 
can be used to navigate around different parts of the document. 

Returns 

Nothing. 
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fw.setActiveWindowO 

Availability 

Fireworks 3 

Description 

Sets the specified document as the active document. 

Arguments 

document, [trueFalse] 

• document is a Document object (for example, fw.documents[2]) that specifies which 
document should be made active. 

• trueFa 1 se (optional) is ignored by Fireworks. It is included only for Dreamweaver 
compatibility. 

Returns 

Nothing. 

Example 

The following command makes the fourth document the active document, 
fw . setActi veWi ndow( fw. documents [3] ) ; 

fw.setFloaterGroupingO 

Availability 

Fireworks 3 

Description 

Moves the specified panel into another specified panel, changing it to a tab within that panel. 
This is the same behavior as dragging a tab from one panel to another or to its own panel. 

Arguments 

panelNameToMove, panel NameToRecel ve 

• panelNameToMove is a lowercase string that specifies the panel to be moved. 

• pane 1 NameToRecel ve is a lowercase string that specifies the panel into which 
panelNameToMove should move. If panel NanieToRecei i/e is null, the panelNameToMove 
moves into its own panel. 

Returns 

Nothing. 

Example 

The following command moves the Stroke tab from its current location into the panel named 
Object. Although the panel name might be capitalized onscreen, it must be passed as lowercase. 

fw . set FI oaterGroupi ng ( "stroke" , "object" ) ; 
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fw.setFloaterPositionO 



Availability 

Fireworks 3 

Description 

Sets the position and size of a panel. 

Arguments 

panel Name , boundi ngRectangl e 

• Acceptable values for pat7e? Waffle are "find", "project log", "object", "info", "url", 
"effect", "history", "mixer", "fill", "stroke", "swatches ", "layers", "frames ", 
"behaviors", "optimize", " 1 i bra ry ", "styl es ", "optimized colors", "options", and 
"tool box". 

• boundi ngRectangl e is a rectangle that specifies the size of the panel (see “Rectangle” on page 
6). Some panels ignore the specified size but place the top left corner of the panel at the top left 
location of the specified rectangle. 

Returns 

Nothing. 

fw.setFloaterVisibilityO 

Availability 

Fireworks 3 

Description 

Shows or hides the specified panel. 

Arguments 

panel Name , bVIsible 

• Acceptable values for pane /Waffle are "find", "project log", "object", "info", "url", 
"effect", "history", "mixer", "fill", "stroke", "swatches ", "layers", "frames ", 
"behaviors", "optimize", "library", "styl es ", "optimized colors", "options", and 
"tool box". 

• If bVisible is true, the specified panel is visible. If bVisible is fal se, the panel is hidden. 

Returns 

Nothing. 
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fw.setHideAllFloatersO 

Availability 

Fireworks 3 

Description 

Shows or hides the panels. This behavior is the same as the tab key functionality. 

Arguments 

bHide 

If bHide is true, the panels are hidden. If bHide is fal se, the panels are visible. 

Returns 

Nothing. 

fw.setPrefO 

Availability 

Fireworks 3 

Description 

Sets the value that is associated with the specified Preference key. 

Arguments 

prefname, prefval 

A complete list of these values is beyond the scope of this documentation, but the format of 
prefname and prefva 1 exactly matches those in the Fireworks Preferences file. To return the 
value that is associated with a Preference key, use fw.getPrefi ). 

Returns 

Nothing. 

fw.setUpFindReplaceO 

Availability 

Fireworks 3 

Description 

Sets up a search. 

Arguments 

findSpec 

findSpec is a Find object (see “Find” on page 15). 

Returns 

Nothing. 
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fw.toggleFloaterO 



Availability 

Fireworks 3 

Description 

Shows, hides, or makes topmost the specified panel. 

• If the panel is not visible, this function makes it visible and topmost. 

• If the panel is topmost, this function hides it. 

• If the panel is visible but not topmost, this function makes it topmost. 

Arguments 

panel Name 

Acceptable values for pat7e? Waffle are "find", "project log", "object", "info", "url", 
"effect", "history", "mixer", "fill", "stroke", "swatches ", "layers", "frames ", 
"behaviors", "optimize", "library", "styl es ", "optimized colors", "options", and 
"tool box". 

Returns 

Nothing. 

fw.ungroupPrimitivesO 

Availability 

Fireworks 4 

Description 

Replaces selected primitive objects with their equivalent paths. The new objects have all the 
attributes of the ones they replaced (mask, stroke, fill, and so on) . 

Arguments 

None. 

Returns 

Nothing. 

Related functions 

dom . addNewRectangl ePri mi ti ve( ) 

fw.updateHTMLO 

Availability 

Fireworks 4 

Description 

Updates the HTML that was previously exported from Fireworks. 
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Arguments 

doc, html Url , bRecoverFromError 

• doc is a Document object that specifies the document to be used for updating the HTML (see 
“Document” on page 9). If doc is nul 1 , the active document is used. 

• html Url IS the filename for the HTML file to update, which is expressed as a file://LlRL. To 
force Fireworks to display the Update HTML dialog box, pass null for html Url . If you pass 
nul 1 for html Url, bRecoverFromError is ignored. 

• If bRecoverFromError is true and the HTML update encounters an error. Fireworks displays 
a Confirmation dialog box and attempts to recover. If it is false. Fireworks fails without 
notifying the user if it encounters an error. 

Returns 

true if the HTML was updated; false otherwise. 

Example 

The following command updates the images in an HTML file, using the current document, 
fw . updateHTMLl nul 1 , "f i 1 e : ///C | /mysi te/nav . htm" , true); 

fw.writePanelStateT oFile() 

Availability 

Fireworks MX 

Description 

Writes out the panel states (location, size, open or closed, and so on), toolbox state, and Property 
inspector state to an XML file that is specified by the argument. 

Arguments 

f1 lepath 

fi 1 epath is a string that identifies the destination XML file in the format file://URL. 

Returns 

Nothing. 

fw.yesNoDialogO 

Availability 

Fireworks MX 

Description 

Prompts the user with a dialog box that contains buttons that are labeled Yes and No. 

Arguments 

promptstring 

promptstring is the prompt message that appears in the dialog box. 
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Returns 

A Boolean value: true if the user selected the Yes button; false otherwise. 

Example 

var shoul dDupl i cate = fw.yesNoDi al og ( "Woul d you like to duplicate the 
el ement? '' ) ; 

Property inspector functions 

These functions control the Properties window, which shows details about the current document 
or selected object. 

fw.showPIWindowO 

Availability 

Fireworks MX 

Description 

Opens the Property inspector window. 

Arguments 

None. 

Returns 

Nothing. 

fw.hidePIWindowO 

Availability 

Fireworks MX 

Description 

Makes the Property inspector window invisible. 

Arguments 

None. 

Returns 

Nothing. 

fw.isPlExpandedO 

Availability 

Fireworks MX 

Description 

Returns the current expanded state of the Property inspector (expanded or minimized). 

Arguments 

None. 

Returns 

A Boolean value: true if expanded; false otherwise. 
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fw.isPIVisibleO 

Availability 

Fireworks MX 

Description 

Returns the current visible state of the Property inspector (hidden or shown). 

Arguments 

None. 

Returns 

A Boolean value: true if visible; false otherwise. 

fw.growPIWindowO 

Availability 

Fireworks MX 

Description 

Sets the Property inspector window to its expanded state. 

Arguments 

None. 

Returns 

Nothing. 

fw.shrinkPIWindowO 

Availability 

Fireworks MX 

Description 

Sets the Property inspector window to its minimized state. 

Arguments 

None. 

Returns 

Nothing. 

fw.setPIPositionO 

Availability 

Fireworks MX 

Description 

Moves the top-left corner of the Property inspector window to the specified location. 

Arguments 

pt 

pt is a point that is given in screen coordinates. 
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Returns 



Nothing. 

fw.getPIPositionO 

Availability 

Fireworks MX 

Description 

Retrieves the location of the top-left corner of the Property inspector in screen coordinates. 

Arguments 

None. 

Returns 

A point object that is formatted as {x: f 1 oat, >>.■ f 1 oat ) (see “Point” on page 6 for syntax details), 
which contains the location of the Property inspector. 

History panel functions 

These functions control the History panel. 

fw.historyPalette.clearStepsO 

Availability 

Fireworks 3 

Description 

Clears the undo and redo stack. 

Arguments 

None. 

Returns 

Nothing. 

fw.historyPalette.copyStepsO 

Availability 

Fireworks 3 

Description 

Copies the selected history steps to the Clipboard. 

Arguments 

array of Indexes 

array of indexes is a zero-based array that specifies which steps from the History panel should 
be copied. If it is null, the currently selected steps are used. 

Returns 

Nothing. 
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fw.historyPalette.getSelectionO 

Availability 

Fireworks 3 

Description 

Determines which steps in the History panel are selected. 

Arguments 

None. 

Returns 

A zero-based array that represents which History panel steps are selected. 

fw.historyPalette.getStepCountO 

Availability 

Fireworks 3 

Description 

Returns the number of steps in the History panel. 

Arguments 

None. 

Returns 

The number of steps in the History panel (not a zero-based value). 

fw.historyPalette.getStepsAsJavaScriptO 

Availability 

Fireworks 3 

Description 

Gets the JavaScript equivalent of the selected steps. 

Arguments 

array of Indexes 

array of indexes is a zero-based array that specifies which steps from the History panel should 
be returned as JavaScript. If the argument is null, the currently selected steps are returned. 

Returns 

A JavaScript string. 

Related functions 

fw . hi story Pal ette . repl aySteps ( ) 
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fw.historyPalette.getUndoStateO 



Availability 

Fireworks 3 

Description 

Returns a string that indicates the current undo state to be used for later calls to 
fw.historyPalette.setUndoStatel). 

Arguments 

None. 

Returns 

The string to use with fw. hi story Pal ette .setUndoState( ). This string is designed to be used 
internally by Fireworks only and might change format in the future. Do not try to parse this 
string or construct a custom string to pass to fw. h i story Palette. set UndoStatel). 

fw.historyPalette.replayStepsO 

Availability 

Fireworks 3 

Description 

Gets the JavaScript equivalent of the selected steps and executes them. 

Arguments 

array of Indexes 

array of indexes is a zero-based array that specifies which steps from the History panel should 
be returned as JavaScript and executed. If the argument is null, the currently selected steps are 
used. 

Returns 

A JavaScript string. 

Related functions 

fw . hi story Pal ette .get Steps As JavaScript!) 
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fw.historyPalette.saveAsCommandO 

Availability 

Fireworks 3 

Description 

Gets the JavaScript equivalent of the selected steps and saves them as a JSF command file. 
Arguments 

array of Indexes, {filename} 

• array of indexes indicates which steps from the History panel should be saved. For 
example, to save the first, third, and sixth steps in the History panel, pass [0, 2, 5]. If this 
argument is null, the currently selected steps are used. 

• f 7 1 ename is an optional string that specifies a name for the JSF command file. It can be any 
string, including a file:// URL. If fi 1 ename is omitted or nul 1 , the user is prompted for a 
filename. If fi 1 ename is not a file://URL, the file is saved in the Fireworks MX/Configuration/ 
Commands folder with the specified filename. 

Returns 

Nothing. 

fw.historyPalette.setSelectionO 

Availability 

Fireworks 3 

Description 

Sets the portion of the History panel that is selected. 

Arguments 

array of Indexes 

array of indexes specifies which steps in the History panel are selected. Values are zero-based. 
For example, to select the first, third, and sixth steps in the History panel, pass [0, 2, 5]. 

Returns 

Nothing. 

fw.historyPalette.setUndoStateO 

Availability 

Fireworks 3 

Description 

Performs the correct number of undo or redo operations to arrive at the selected state. 

Arguments 

undoStateStri ng 

undoStateStri ng is the string that fw. hi story Pal ette.getUndoStatei) returns. 

Returns 

Nothing. 
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Using the common API 

To enable commands to use a common syntax (and perhaps the ability to run a single command 
in multiple applications), a common Macromedia API exists. You can access this API using 
app.methodName( ).The following methods are currently supported in Fireworks and 
Dreamweaver to let developers easily create commands for both applications. 

app.toggleFloaterO 

Identical to “fw.toggleFloaterO” on page 193. 

app.setFloaterVisibilityO 

Identical to “fw.setFloaterVisibilityO” on page 191. 

app.getRootDirectoryO 

Identical to “a p p D i r • ” on page 17. 

app.browseDocumentO 

Identical to “fw.browseDocumentO” on page 168. 

Note: app.getRootDirectoryO is helpful for using app.browseDocumentO to view files within the applications’s 
folder. 

Using the addBehavior() function 

The following code shows the syntax fordom.adclBehavior(): 

fw . getDocumentDOMf ). addBehavi or( act 7on, event, eventindex); 

The first argument is a string that specifies the behavior to be added (see “dom.addBehaviorO” on 
page 58). The information in this section describes the acceptable values for the first argument 
that is passed to dom.addBehaviorf ). 

MM_nbGroup [down] 

Availability 

Fireworks 3 

Description 

Sets a navigation bar “down” behavior. 

Arguments 

type, barName, target, swapFrame, fileName, preload 

• Pass "down" for type. 

• Pass " n a V b a r 1 " for the name of the navigation bar. 

• target specifies the slice to which the behavior is attached. Pass -1 for this value; all other 
values are used internally by Fireworks. 

• swapFrame is a zero-based integer that specifies the frame to swap. To use fi 1 etiame as a URL, 
pass - 1 here. 
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• f 7 1 eName specifies the frame or file to swap. If you specified a frame to use in swapFrame, pass 
an empty text string. If you want to specify a filename and you passed -1 for swapFrame, pass 
the string for the relative URL of the image. 

• prel oadis A binary value that specifies whether to preload the swapped image (pass 1) or not 
(pass 0). 

Example 

fw . getDocumentDOM( ).addBehavior( "MM_nbGroup( \ ’down\ ’,\’navbarl\’,- 
"onClick", -1); 

MM_nbGroup [highlight] 

Availability 

Fireworks 3 

Description 

Sets a navigation bar highlight behavior. 

Arguments 

type, target, swapFrame, fileName, preload, downHi ghl i ght , downHI ghl 1 ghtFrame , 
downHIghl IghtFi lename 

• Pass ''over” for type. 

• target specifies the slice to which the behavior is attached. Pass -1 for this value; all other 
values are used internally by Fireworks. 

• swapFrame is a zero-based integer that specifies the frame to swap. To use fi 1 eName as a URL, 
pass -1 here. 

• f 7 1 eName specifies the frame or file to be swapped. If you specified a frame to use in swapFrame, 
pass an empty text string. If you want to specify a filename and you passed -1 for swapFrame, 
pass the string for the relative URL of the image. 

• prel oad is A binary value that specifies whether to preload the swapped image (pass 1) or not 
(pass 0). 

• downHi gh 1 i ght is a binary value that specifies whether an image should be used for 
highlighting on mouse down (pass 1) or not (pass 0). If you pass 1, use the next two arguments 
to specify the frame or image to be used. 

• downHi gh 1 i ghtFrame is a zero-based integer that specifies the frame to use as a highlight 
image. To use downHi ghl i ghtFrame as a URL, pass -1 here. 

• downHighl ightFi lename specifies the frame or file to be used as the highlight image. If you 
specified a frame to use in downHi gh 1 i ghtFrame, pass an empty text string. If you want to 
specify a filename and you passed - 1 for downHi gh 1 i ghtFrame, pass the string for the relative 
URL of the image. 

Example 

fw . getDocumentDOM( ).addBehavior( "MM_nbGroup( \ ' over \ ' , - 1 , 1 , \ \ , 1 , 0 , 3 , \ \ , 
''onMouseOver'' , -1); 
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MM_nbGroup [image] 

Availability 

Fireworks 3 

Description 

Sets a navigation bar image behavior. 

Arguments 

type, downHI ghl i ght , 1 n1 t1 allyDown 

• Pass "all " for type. 

• down High 1 i ght is a binary value that specifies whether the image should be highlighted on a 
mouse down action (pass 1) or not (pass 0). 

• initial lyDown is a binary value that specifies whether the image should initially appear as in 
the “down” state (pass 1) or not (pass 0). 

Example 

fw . getDocumentDOMl ).addBehavior( "MM_nbGroup( \’all\’,l,0)", "onMouseOver", -1); 

MM_nbGroup [out] 

Availability 

Fireworks 3 

Description 

Sets a navigation bar restore behavior. 

Arguments 

type 

Pass "out" for type. 

Example 

fw . ge t Document DOM ( ).addBehavior( "MM_nbGroup( \’out\’)", "onMouseOut", -1); 

MM_simpleRollover 

Availability 

Fireworks 3 

Description 

Adds a simple rollover behavior. 

Arguments 

None. 

Example 

fw . getDocumentDOMl ).addBehavior( "MM_si mpl eRol 1 over( ) " , "onMouseOver" , - 1 ) ; 
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MM_statusMessage 

Availability 

Fireworks 3 

Description 

Sets a status bar message. 

Arguments 

message 

message is a string that specifies the status message to appear. 

Example 

fw . getDocumentDOM( ).addBehavior( "MM_statusMessage( \ "Status Message ! \ ")" , 
"onMouseOver" , -1); 

MM_swaplmage 

Availability 

Fireworks 3 

Description 

Adds a swap image behavior. 

Arguments 

target, swapFrame, fUeName, preload, restoreOnMouseOut 

• target specifies the slice to which the behavior is attached. Pass -1 for this value; all other 
values are used internally by Fireworks. 

• swapFrame is a zero-based integer that specifies the frame to swap. To use fi 1 etlame as a URL, 
pass - 1 here. 

• fi 1 eName specifies the frame or file to swap. If you specified a frame to use in swapFrame, pass 
an empty text string. If you want to specify a filename and you passed -1 for swapFrame, pass 
the string for the relative URL of the image. 

• prel oad is 3 . binary value that specifies whether to preload the swapped image (pass 1) or not 
(pass 0). 

• restore is 3 binary value that specifies whether to restore on a mouse out action (pass 1) or 
not (pass 0). 

Example 

fw . getDocumentDOM( ).addBehavior( "MM_swap Image! - 1 , 1 , \ \ , 1 , 1 ) " , "onMouseOver" , 
- 1 ) : 
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M M_s wap I m g R esto re 

Availability 

Fireworks 3 

Description 

Adds a swap image restore behavior. 

Arguments 

None. 

Example 

fw . getDocumentDOM( ).addBehavior( "MM_swapImgRestore( ) " , "onMouseOut , - 1 ) ; 

Using Macromedia Flash to create custom panels and 
commands 

Fireworks MX contains a special Macromedia Flash reader that lets Shockwave files (SWFs) play 
as panels and commands in the Fireworks interface. Additionally, developers can install a 
Macromedia API wrapper extension for Macromedia Flash to facilitate creating SWFs that 
communicate with the Fireworks API. By leveraging the new API communication between 
Macromedia Flash and Fireworks, Fireworks extension developers can create interfaces and dialog 
boxes for their commands that go beyond the a 1 ert ( ) and prompt ( ) dialog boxes that are 
supported in previous versions. You can add command panels to Fireworks MX for image 
enhancements, object manipulation, or for other custom functionality. 

How custom panels and commands work 

Macromedia Flash developers can create interactive movies that contain a combination of 
ActionScript and calls to the Fireworks API for two types of deployment: interactive panels or 
modal commands. Basically, while writing ActionScript, a Macromedia Flash developer can 
embed commands for the Fireworks API in the MMExecute ( ) function, or by using the API 
wrapper extension for Macromedia Flash. These Macromedia Flash animations can be 
constructed as interactive panels that work the same as built-in panels, such as the Layers panel or 
the Frames panel. 

SWFs that are published to the Fireworks MX installation directory, Configuration\Command 
Panels subfolder act as panels in the Fireworks interface at runtime and are available through the 
Window menu. 

SWFs that are published to the Configuration\Commands subfolder act as modal commands and 
are available through the Commands menu in the Fireworks interface. 

Note: On multiuser systems, Fireworks supports a Command Panels folder inside of each user’s Configuration 
folder, so users can save favorite panels. 

At runtime. Fireworks has a special Macromedia Flash player that runs the SWF animations, or 
commands, as the user clicks on the custom command options, which is similar to the Window > 
Align panel. 

Developing Fireworks panels and commands in Macromedia Flash 

Any part of the Fireworks API can be called by embedding them in the following Macromedia 
Flash API functions. These functions communicate directly with the special Macromedia Flash 
player that is distributed with Fireworks MX: 
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MMExecuteO 



Description 

Declares a set of JavaScript to pass to the Fireworks API, allowing Flash authors to embed 
Fireworks API commands in a frame of a Flash movie. 

Note: MM Execute supersedes the FWJavascri pt command. However, the FWJavascri pt command still works in 
the current version of Fireworks. 

Arguments 

jsToPass 

jsToPass is a string of JavaScript for Fireworks to execute. 

Returns 

Nothing. 

Exampie 

MMExecute( "fw . get Document DOM ( ) . addNewRectangl ePri mi ti ve( { 1 eft : 47 , top : 26 , 
right:102, bottom:87), 0"); 

MMEndCommandO 

Description 

This function should be called by whatever OK or Cancel buttons that the Macromedia Flash 
author provides to the user to execute a command (only for modal commands, not for Flash 
panels) . 

Note: MMEndCommand supersedes the FWEndCommand command. However, FWEndCommand still works in the current 
version of Fireworks. 

Arguments 

endStatus, noti fyStri ng 

• endStatus is a Boolean value: true to commit changes; false otherwise. If it is false, any 
changes the command or panel might have made to the document are discarded. To commit 
the changes, endStatus must be true. 

• t) 0 1 7 fyS t r 7 1) g is a string to notify the user of errors; use only if you pass “false” for the first 
argument. For OK, pass an empty string. 

Returns 

Nothing. 

Using the API wrapper extension in Macromedia Flash 

You can install a special extension that was developed specifically for writing Fireworks functions 
into ActionScript either as a replacement for, or in conjunction with, using MMExecutef ) and 
MMEndCommand ( ). After it is installed, the API wrapper appears in the Macromedia Flash interface 
to make writing commands for Fireworks easier. Instead of having to embed every Fireworks 
function inMMExecutef), you can use a series of fwapi functions in the ActionScript. Then, 
when it is published, the wrapper translates the fwapi functions into the expanded Fireworks 
functions. You can also mix the fwapi functions with MMExecutef ) statements. 
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To install the API wrapper, make sure you have the Macromedia Extensions Manger installed and 
double-click on the Extension file. In Macromedia Flash, the wrapper appears in the Components 
window as FWCommandComponents. 

The following example shows a command without the wrapper: 
var path = MMExecute( "fw. appPatternsDi r ; " ) ; 

The following example shows the same command using the wrapper: 
var path =fwapi . getAppPatternsDi r( ) ; 

Working with AS files 

Keeping a separate .as file for the ActionScript allows for easier edits later without having to open 
and edit the FLA file directly. Your FLA file needs to have a #i ncl ude "mySt ri ngFi 1 e . as " in 
the first frame (where “myStringFile” is the actual name of your AS file) so the ActionScript 
strings are complied at publishing time. 

Note: The FLA files and the AS files should reside in the same folder so that there is no problem finding the AS file 
for compiling. 

Guidelines for creating panels and commands 

Nested quotation marks need to use the backslash convention (\). The following example 
prints: John ’ s example is really “complex”! 

MMExecutef ' al ert( " John\ ' s example is really \"compl ex\" ! " ) ' ; 

• The movie size set in Flash is used in Fireworks as the minimum and default size for the 
command panel. 

• To improve the appearance and positioning of a modeless panel, turn off scaling and align the 
panel contents to the top-left corner of the stage. You can make these changes with the 
following ActionScript: 

Stage . al i gn = "TC" : 

Stage . seal eMode = "noScale": 

Publishing 

When testing your script, use the File > Publish menu option in Macromedia Flash MX. The 
SWF file is in the same place as the FLA file after publishing. 

Debugging 

Use the following functions to show or hide everything that the SWF passes to the Fireworks API 
during execution. Place these debug functions around the suspect code in your Macromedia Flash 
ActionScript to turn the debug functions on or off as needed. Be careful to use these functions 
only around “suspect” code; otherwise, you might encounter a long series of dialog statements. 

Note: The debugging commands work even if you are running a ,]sf file. 
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fw.enableFlashDebuggingO 



Availability 

Fireworks MX 

Description 

Turns on debug messages for Flash commands. When Flash debugging is enabled, every time a 
Flash command calls MMExecute(), Fireworks displays the command string in a dialog box. This 
function is particularly useful for monitoring which commands are executed in a command panel. 

Arguments 

None. 

Returns 

Nothing. 

fw.disableFlashDebuggingO 

Availability 

Fireworks MX 

Description 

Turns off debug messages for Flash commands. See “fw.enableFlashDebuggingO” on page 208 for 
a description of the Flash debugging capabilities. 

Arguments 

None. 

Returns 

Nothing. 
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Convert to Alpha properties (Effect object) 25 
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dom.closeO 78 
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dom.removeGuideO 116 
dom.removeTransformationO 117 
dom.reorderFrameO 117 
dom.reorderLayerO 117 
dom.replaceButtonTextStringsO 118 
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dom.setShowGammaPreviewO 154 
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dom.setShowGridO 154 
dom.setShowGuidesO 155 
dom.setShowRulersO 155 
dom.setShowSliceGuidesO 155 
dom.setShowSliceOverlayO 156 
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dom.setSliceExportOptionsO 156 
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EAppAlreadyRunning 13 
EAppNotSerialized 13 
EArrayIndexOutOfBounds 13 
EBadFileContents 13 
EBadJsVersion 13 
EBadNesting 13 
EBadParam 1 3 
EBadParamType 1 3 
EBadSelection 13 
EBufferTooSmall 1 3 
ECharConversionFailed 13 
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enableFlashDebuggingO 208 
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ENoActiveDocument 13 
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EWrongType 1 3 
exitElementMaskEditMode 90 
exitPaintModeO 90 
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exportDoc object 46 
exportDocumentAsO 173 
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exportFramesO 175 
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ExportSettings object 36 
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fw.historyPalette.copyStepsO 197 
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historyPalette.setSelectionO 200 
historyPalette.setUndoStateO 200 
Flotspot object 30, 52 
HTML export objects 44 
Hue (Effect object) 26 
Hue/Saturation (Effect object) 26 
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I 

Image object 30 
ImageMap object 48 
ImagemapList object 48 
importFileO 98 
importSymbolO 98 
importSymbolButNotAsAliasO 99 
index arguments 57 
inLaunchAndEditO 99 
Inner Shadow (Effect object) 27 
insertPointInPathO 100 
Instance object 30, 53 
Invert property (Effect object) 27 
isPIExpandedO 195 
isPIVisibleO 196 

isSelectionDirectlyAboveBitmapObjectO 100 

JavaScript 
books 5 

checking the API for incompatibilities 169 
executing steps from the Elistory panel 199 
extensibility file 7 

returning steps from the History panel 198 
running a script file 187 
saving a string as a command file 189 
saving steps to a command file 200 
syntax 5 

undoing functions 167 
JavaScript wrapper 206 
joinPathsO 100 

K 

knifeElementsFromPointO 101 
knifeElementsFromPointsO 101 

U 

launchAppO 182 
launchBrowserToO 183 
Layer object 40 
layerindex argument 57 
Levels (Effect object) 27 
linkElementMaskO 102 
loadColorPaletteO 91 
locateDocDialogO 20 

M 

makeActiveO 103 
makeFindO 102 
makeGoodNativeFilePathO 102 
mask 6 



matrix 6 

mergeDownO 103 
Metafile. htt 44 
methods, global 9 
MM_nbGroup 
[down] 201 
[highlight] 202 
[image] 203 
[out] 203 

MM_simpleRollover 203 
MM_statusMessage 204 
MM_swapImage 204 
MM_swapImgRestore 205 
MMEndCommandO 206 
MMExecuteO 206 
modifyPointOnPathO 103 
moveBezierHandleByO 1 04 
moveElementMaskBy 0 104 
moveFillVectorHandleByO 105 
moveMaskGroupContentsByO 105 
movePixelMaskByO 106 
movePointOnHotspotByO 106 
movePointOnHotspotByWithFlagsO 1 07 
moveSelectedBezierPointsByO 107 
moveSelectionByO 107 
moveSelectionMaskByO 108 
moveSelectionToO 108 
moveSelectionToFrameO 109 
moveSelectionToLayerO 109 
moveSelectionToNewLayerO 110 

N 

null values 57 

O 

object 

Behavior 21 

BehaviorInfo 44 

BehaviorsList 45 

Brush 21 

Gontour 22 

GontourNode 22 

GontourNodeDynamicInfo 23 

Document 9 

Effect 23 

EffectList 29 

Element 29 

ElementMask 32 

Errors 12 

exportDoc 46 

ExportFrameInfo 33 
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ExportOptions 33 
ExportPaletteInfo 35 
ExportSettings 36 
Files 13 
Fill 38 
Find 15 
Fireworks 1 7 
Frame 38 

FrameNLayerIntersection 39 

Gradient 39 

GradientNode 39 

Group 29, 53 

Guides 39 

Flotspot 30, 52 

Image 30 

ImageMap 48 

ImagemapList 48 

Instance 30, 53 

Layer 40 

Path 31, 53 

PathAttrs 40 

Pattern 41 

pngText 12 

RectanglePrimitive 41, 54 
SingleTextRun 41 
SliceHotspot 31, 53 
Sliceinfo 49 
Slices 50 
Style 41 
Text 31, 54 
TextAttrs 43 
TextRuns 44 
Texture 32 
objects 

accessing within documents 20 
classification 51 
core objects 9 
selected 51 
openDocumentO 183 
Operating on a selection 57 
optional arguments 8 

P 

palette 57 
panel 57 

panels, custom 205 
Path object 31, 53 
pathAttributes property 54 
PathAttrs object 40 
pathGropO 110 
pathExpandO 110 



pathInsetO 111 
pathIntersectO 111 
pathPunchO 111 
pathSimplifyO 112 
pathUnionO 112 
Pattern object 41 

Photoshop document, exporting as 176 
pngText 12 
point 6 

popupGolorPickerO 1 84 

popupGolorPickerOverMouseO 184 

previewInBrowserO 112 

primitive 64 

prompt!) 9 

PSD, exporting as 176 

Q 

quit!) 185 

quitApplicationO 185 

R 

readNthTableO 185 

readPanelStateFromFileO 1 86 

rebuildGolorTableO 113 

rectangle 6 

rectangle primitive 64 

RectanglePrimitive object 41, 54 

redoO 113 

redraw!) 113 

reflectSelectionO 113 

removeAllGuides 0 114 

removeBehaviorO 114 

removeBrush!) 115 

removeGharacterMarkup!) 115 

removeElementMaskO 115 

removeFill!) 116 

removeFontMarkup!) 116 

removeGuideO 116 

removeTransformation!) 117 

reorderFrameO 117 

reorderLayer!) 117 

replace!) 186 

replaceAll!) 186 

replaceButtonTextStringsO 118 

replaceButtonTextStringsInInstancesO 118 

replaceTextString!) 119 

replaySteps!) 199 

resizeSelectionO 119 

resolution 6 

restoreJPEGMaskO 119 

restoreSelection!) 120 
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reversePathTextDirectionO 120 
revertDocumentO 187 
rotateDocumentO 120 
rotateSelectionO 121 
runScriptO 187 

S 

Saturation properties (Effect object) 26 

saveO 121 

saveAllO 187 

saveAsCommandO 200 

saveColorPaletteO 91 

saveCopyAsO 121 

saveDocumentO 188 

saveDocumentAsO 188 

saveDocumentCopyAsO 188 

saveJPEGMaskO 122 

saveJsCommandO 189 

saveSelectionO 122 

scaleSelectionO 122 

selectAdjustPixelSelO 123 

selectAllO 123 

selectAllOnLayerO 124 

selectChildrenO 124 

selected objects 5 1 

selectFeatherO 124 

selectInverseO 125 

selection 57 

selectNoneO 125 

selectParentsO 125 

selectSimilarO 126 

selectSimilarFromPointO 126 

setActiveViewScaleO 189 

setActive Window)) 189, 190 

setAllLayersDisclosureO 127 

setAnimlnstanceLoopCountO 127 

setAnimlnstanceNumFramesO 127 

setAnimlnstanceOffsetDistO 128 

setAnimlnstanceRotationAmountO 128 

setAnimlnstanceScaleAmountO 128 

setAnimlnstanceStartEndOpacityO 129 

setAnimlnstanceStartFrameO 129 

setBlendModeO 130 

setBrushO 130 

setBrushColorO 130 

setBrushNameO 131 

setBrushNColorNTextureO 131 

setBrushPlacementO 131 

setButtonAutoSliceO 132 

setButtonIncludeDownStateO 132 

setButtonIncludeOverWhileDownState 1 32 



setButtonIncludeOverWhileDownStateO 1 32 

setButtonOptions 133 

setButtonOptionsO 133 

setButtonShowDownOnLoadO 133 

setDefaultBrushAndFillColorsO 1 34 

setDefaultFillVectorO 134 

setDocumentCanvasColorO 134 

setDocumentCanvasSizeO 135 

setDocumentCanvasSizeToDocumentExtentsO 135 

setDocumentCanvasSizeToSelectionO 136 

setDocumentImageSizeO 136 

setDocumentResolutionO 136 

setEffectNameO 1 37 

setElementMaskModeO 137 

setElementMaskShowAttrsO 137 

setElementNameO 138 

setElementVisibleO 138 

setElementVisibleByNameO 1 39 

setExportOptionsO 139 

setExportSettingsO 139 

setFillO 140 

setFillColorO 140 

setFillEdgeModeO 140 

setFillNColorO I4l 

setFillNColorNTextureO I4l 

setFillPlacementO 14 1 

setFillVectorO 142 

setFillVectorStartO 142 

setFloaterGroupingO 190 

setFloaterPositionO 191 

setFloaterVisibilityO 191, 201 

setGradientNameO 143 

setGridGolorO 144 

setGridOriginO 143 

setGridSizeO 143 

setGroupTypeO 144 

setGuideColorO 144 

setEIideAllFloatersO 192 

setEIotspotAltTagO 145 

setEIotspotGolorO 145 

setEIotspotRectangleO 145 

setEIotspotShapeO 146 

setEIotspotTargetO 146 

setEIotspotTextO 1 47 

setLayerDisclosureO 147 

setLayerLockedO 148 

setLayerNameO 148 

setLayerSharingO 149 

setLayerVisibleO 149 

setMatteColorO 150 



218 Index 




setOnionSkinningO 151 
setOpacityO 151 
setPIPositionO 196 
setPixelMaskO 150 
setPrefO 192 
setQuadrangleO 151 
setRectRoundnessO 152 
setRectSidesO 152 
setSelectionO 200 
setSelectionBoundsO 1 53 
setSelectionMaskO 153 
setShowEdgesO 153 
setShowGammaPreviewO 154 
setShowGridO 154 
setShowGuidesO 155 
setShowRulersO 155 
setShowSliceGuidesO 155 
setShowSliceOverlayO 156 
setSliceAutonamingO 156 
setSliceExportOptionsO 156 
setSliceFilenameO 157 
setSliceGuideGolorO 157 
setSliceEItmlO 157 
setSlicelsEltmlO 158 
setSnapToGridO 158 
setSnapToGuidesO 158 
setSymbolPropertiesO 159 
setTextAlignmentO 159 
setTextAntiAliasingO 159 
setTextAutoKernO 160 
setTextCharSpadngO 1 60 
setTextFlowO 160 
setTextFIorizontalScaleO 161 
setTextLeadingO 161 
setTextOnPathModeO 161 
setTextOnPathOffsetO 1 62 
setTextOrientationO 162 
setTextParaIndentO 162 
setTextParaSpadngAfterO 163 
setTextParaSpadngBeforeO 163 
setTextRectangleO 164 
setTextRectangleAutoO 164 
setTextRectangleAutoFromPointO 1 65 
setTextRunsO 163 
setTransformModeO 164 
setUndoStateO 200 
setUpFindReplaceO 192 
Sharpen (ElFect object) 28 
Sharpen More (Effect object) 28 
showAllHiddenO 165 



showPIWindowO 195 
shrinkPI Window)) 196 
SingleTextRun object 41 
sliced images 44 
SliceFlotspot object 31, 53 
Sliceinfo object 49 
Slices object 50 
Slices. htt 44 
splitPathsO 166 

strokes, finding and replacing 16 
Style object 41 

styles, finding and replacing 1 6 
swapBrushAndFillGolorsO 166 
SWF, exporting as 177 
syntax conventions 58 

T 

templates 44 
Text object 31, 54 
text, finding and replacing 15 
TextAttrs object 43 
TextRuns object 44 
Texture object 32 
toggleFloaterO 193, 201 
transformSelectionO 1 66 
tweenO 167 

U 

undoO 167 

ungroupO 168 

ungroupPrimitivesO 193 

Unsharp Mask property (Effect object) 

updatelTTMLO 193 

updateSymbolO 1 67 

URLs, finding and replacing 16 

V 

values 8 

W 

write)) 9 

WRITE_HTML() 9 
writePanelStateToFileO 194 

Y 

yesNoDialogO 194 

Z 

zero-based indexes 57 
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